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简 介 











云 计 算是 一 种 具有 开创 性 的 、 令 人 兴奋 的 编程 及 使 用 电脑 的 方式 。 它 为 软件 开发 人 员 创造 了 
巨大 的 机 会 : 云 计 算 能 够 为 构建 新 型 应 用 提供 一 个 极 棒 的 新 平台 。 在 这 一 章 中 , 我 们 将 了 解 一 些 
基本 概念 : 什么 是 云 计算 ， 何 时 应 该 使 用 它 ， 为 什么 应 该 使 用 它 ， 以 及 应 用 程序 开发 人 员 可 以 利 
用 哪些 类 型 的 基于 云 的 服务 。 


1.1 什么 是 云 计算 
在 了 解 如 何 使 用 Google App Engine 编 写 云 程序 之 前 , 我 们 从 最 基础 的 开始 ， 先 弄 清楚 云 计算 


指 的 是 什么 ， 什 么 是 云 ， 它 与 桌面 计算 以 及 老式 的 客户 /服务 器 计算 模式 有 什么 不 同 。 最 重要 的 
是 要 明白 为 什么 软件 开发 人 员 需 要 关心 云 ， 何 时 需要 使 用 云 ， 以 及 应 该 用 云 来 做 什么 。 



































1.1.1 云 的 概念 


在 现代 互联 网 和 万 维 网 的 世界 中 ,数据 中 心 分 布 于 世界 各 地 ， 每 个 数据 中 心 都 拥有 成 千 上 

台 计 算 机 。 使 用 这 些 计算 机 已 经 成 了 人 们 的 日 常 活动 ， 我们 通过 计算 机 与 他 人 聊天 、 发 送 电 

子 邮 件 、 玩 游戏 、 读 博客 、 写 博客 ， 这 些 活动 其 实 是 以 浏览 右 作 为 客户 端 ， 去 访问 在 服务 器 端 
运行 的 程序 。 

但 是 ， 程 序 实际 上 在 哪里 运行 呢 ? 数据 存放 在 哪里 ”服务 器 在 哪里 ? 它们 总 归 位 于 某 个 地 
方 ， 放 在 某 个 数据 中 心 ， 呆 在 世界 的 某 个 角落 。 用 户 并 不 知道 在 哪里 ， 更 重要 的 是 ， 用 户 不 用 去 
关心 ， 也 根本 没有 理由 去 关心 。 用 户 在 意 的 是 在 需要 的 时 候 要 能 够 访问 到 这 些 程序 和 数据 。 

让 我 们 看 一 个 简单 的 例子 。 几 年 前 ， 我 开始 写 博 客 。( 该 博客 虽然 已 经 搬迁 走 了 ， 但 仍然 是 
个 很 好 的 例子 )。 开 始 时 ， 我 使 用 Google 的 Blogger 服 务 。 每 天 ， 我 会 打开 网 络 浏览 器 ， 进 入 
http:/goodmath.blogspot.com/admin， 然 后 开始 写作 。 写 完 后 点 击 “ 发 表 ” 按 钮 ， 博 客 的 内 容 就 会 
呈现 给 我 所 有 的 读者 。 从 我 的 角度 来 看 , 它 就 是 这 么 工作 的 。 我 只 需要 网 络 浏览 器 以 及 URL 地 址 ， 
就 能 够 写 博客 。 

在 后 台 , Blogger 是 在 Google 某 数据 中 心 运行 的 一 款 复杂 软件 。 它 承载 了 数 十 万 的 博客 , 并 且 
每 天 都 会 有 数 百 万 的 用 户 来 访问 这 些 博客 。 从 这 个 角度 看 ， 显 而 易 见 ， 支 撑 Blogger 的 软件 运行 
在 很 多 台 计 算 机 上 。 有 多 少 台 呢 ? 我 们 不 知道 。 实 际 上 , 它 甚 至 都 可 能 不 是 一 个 固定 的 数目 一 一 
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当 访 问 用 户 不 很 多 时 ， 就 不 需要 在 很 多 机 器 上 运行 该 软件 ; 当 越 来 越 多 的 人 开始 用 它 时 ， 就 逐步 
需要 更 多 的 机 器 了 。 运 行 这 个 软件 的 机 器 数目 是 变化 的 。 但 是 ,从 用 户 的 角度 来 看 一 一 不 管 是 博 
客 的 作者 还 是 博客 的 读者 ， 都 不 需要 关心 机 需 的 数量 这 一 问题 。Blogger 是 一 项 服务 ， 并 且 能 够 
正常 工作 ， 这 就 够 了 。 当 我 想 写 博 客 时 ， 就 可 以 进入 Blogger 编 写 ， 人 们 只 要 进入 我 的 博客 网 页 ， 
就 可 以 阅读 它 。 

这 就 是 云 的 基本 理念 : 程序 和 数据 在 某 个 地 方 的 计算 机 上 , 用户 不 需要 知道 也 不 需要 关心 这 
台 计 算 机 在 哪里 。 

为 什么 将 这 些 资源 的 集合 称 为 云 ? 云 是 大 量 微小 水 滴 的 集合 。 有 些 水 滴 会 落 在 我 的 院子 里 ， 
滋养 树木 和 草坪 ， 有 些 会 流入 供给 我 饮用 水 的 水 库 里 。 而 云 本 身 由 各 地 蒸发 的 水 分 形成 。 我 只 和希 
望 在 院子 里 有 足够 的 水 分 可 以 淡 养 植物 ,而 且 水 库 中 蓄 水 充足 让 我 饮用 , 我 才 不 关心 是 哪 片 云 带 
来 了 降雨 ,所 有 的 云 对 我 来 讲 都 是 一 样 的 。 我 不 关心 水 来 自 于 地 球 的 哪个 地 方 , 它 们 都 只 是 水 一 一 
每 个 水 滴 儿 乎 完全 相同 ， 我 看 不 出 区 别 。 只 要 有 充足 的 水 ， 我 就 心满意足 了 。 

所 以 , 试想 世界 各 地 的 各 类 数据 中 心 所 在 的 公司 都 设 有 大 量 的 计算 机 ， 就 如 同 云 。 很 多 网 络 
计算 方面 的 最 大 参与 者 (包括 Google、Amazon、Microsoft、IBM 和 Yahoo ) 都 有 几 千 台 机 器 接 和 人 
网 络 ， 运行 着 各 类 软件 。 每 个 这 样 的 数据 中 心 都 是 一 片 去 ， 每 个 处 理 器 、 每 个 硬盘 都 是 云 中 的 水 
滴 。 在 云 的 世界 中 ,开发 者 编写 程序 时 ， 不 知道 程序 会 在 哪个 计算 机 上 运行 。 开 发 者 不 知道 存储 
数据 的 硬盘 在 哪里 ， 而 且 也 不 需要 关心 。 开 发 者 只 需要 清楚 自己 需要 多 少 “ 水 滴 ”。 


1.1.2 云 与 开发 者 


云 计算 从 根本 上 改变 了 过 去 计算 机 和 软件 的 使 用 方式 。 传统 上 , 如果 用 户 想 要 运行 某 个 应 用 
程序 ， 会 去 买 一 台 计算 机 和 一 些 软件 , 在 自己 家 里 安装 好 软 硬 件 ， 然 后 运行 程序 。 用 户 需要 考虑 
该 运行 什么 操作 系统 , 自己 安装 好 软件 , 并 且 需 要 维护 计算 机 一 一 跟踪 软件 升级 、 安 全 、 备 份 等 。 

有 了 云 计 算 ， 用 户 不 需要 再 做 上 述 工 作 。 使 用 云 的 话 ， 你 只 需要 购买 想 要 的 应 用 程序 的 访 
问 权 ， 然 后 就 可 以 在 任何 地 方 访问 该 应 用 程序 。 安 装 软 件 、 维 护 程序 运行 所 需 的 软 硬 件 、 保 持 
数据 安全 可 靠 ， 这 些 问 题 都 不 需要 你 来 考虑 。 在 云 计算 环境 下 ， 你 所 购买 的 软件 就 是 服务 。 如 
果 需 要 比 普通 用 户 更 多 的 存储 空间 ， 你 可 以 从 服务 提供 商 处 购买 额外 的 存储 空间 。 如 果 这 样 意 
味 着 需要 购买 和 安装 新 的 硬盘 ， 那 也 由 服务 提供 商 负责 。 你 只 是 从 他 们 那里 购买 了 存储 服务 ， 
具体 如 何 提供 服务 则 是 他 们 的 问题 。 你 告诉 他 们 你 需要 什么 ， 既 包括 实际 的 物理 层面 (“ 我 需要 
1TB 存 储 空间 ”)， 也 包括 略为 抽象 一 点 的 服务 质量 层面 (“我 需要 确保 存储 是 事务 性 的 ， 在 我 提 
交 一 个 修改 后 ， 数 据 不 会 丢失 ”)。 你 告诉 云 计 算 服务 商 你 有 什么 需求 ， 他 们 就 会 卖 给 你 满足 这 
些 需 求 的 服务 。 

这 就 意味 着 ， 当 开发 者 做 云 计算 软件 开发 时 ,不 再 是 购买 计算 机 并 在 其 上 运行 软件 ， 而 是 将 
工作 拆 分 为 基本 的 “积木 块 "， 然 后 从 服务 提供 商 那里 购买 这 些 积木 块 ， 最 后 根据 自己 想 要 搭建 
的 系统 将 积木 块 组 合 在 一 起 。 

这 些 “ 积 木 块 ”就 是 开发 者 运行 程序 或 者 执行 任务 所 需 的 资源 , 包括 如 处 理 时 间 、 网 络 带 宽 、 
磁盘 存储 空间 、 内 存 等 内 容 。 作 为 云 计算 的 使 用 者 ,你 不 需要 关心 这 些 资源 位 于 何 处 。 你 只 需 知 



























































































































































道 自己 需要 什么 ， 然 后 从 能 够 提供 最 便捷 服务 的 提供 商 处 购买 即 可 。 

对 于 开发 者 而 言 ， 云 计算 引入 了 更 为 巨大 的 变化 。 当 开发 者 做 云 计算 开发 时 ,他 并 不 是 在 实 
现 一 个 软件 , 然后 销售 给 客户 ,而 是 在 为 他 的 客户 创建 一 个 可 供 使 用 的 服务 。 了 人 解 这 其 中 的 区 别 
至 关 重 要 : 开发 者 时 刻 要 并 记 是 要 提供 给 用 户 一 种 服务 ,而 不 是 给 他 们 一 个 要 安装 在 他 们 的 计算 
机 上 运行 的 独立 应 用 程序 。 客 户 会 根据 他 们 要 完成 的 任务 选择 服务 , 所 以 你 的 应 用 程序 要 根据 这 
个 任务 来 设计 ， 并 且 必 须 尽 可 能 以 最 灵活 的 方式 提供 相应 的 服务 。 

例如 ,如 果 开 发 者 想 为 桌面 计算 机 创建 一 个 待 办 事项 列表 的 应 用 程序 , 这 是 一 个 相当 简单 的 
过 程 ,虽然 用 户 界面 的 布局 可 能 有 很 多 种 方式 ,但 是 创建 这 么 一 个 系统 的 基本 思路 是 显而易见 的 。 
开发 者 会 创建 一 个 用 户 界面 一 一 当然 不 需要 创建 多 个 , 而 且 主要 为 单 用 户 创建 。 如 果 为 云 开发 待 
办 事项 列表 应 用 程序 ,那么 ,开发 者 就 需要 有 多 个 用 户 界 面 了 : 最 起 码 ， 为 通过 桌面 计算 机 访问 
这 一 服务 的 人 提供 一 个 界面 , 为 通过 手机 上 的 移动 浏览 絮 访 问 这 一 服务 的 人 提供 一 个 界面 。 开发 
者 可 能 还 要 提供 一 个 开放 式 接口 ， 以 便 其 他 开发 人 员 能 够 用 它 来 创建 其 他 设备 的 客户 端 。 另 外 ， 
开发 者 需要 针对 多 用 户 进行 设计 ， 因 为 应 用 程序 一 旦 发 布 到 云 中 , 虽然 只 是 单个 应 用 程序 , 但 却 
会 被 很 多 人 使 用 。 因 此 , 开发 者 设计 程序 时 要 有 这 个 准备 ， 即 使 用 户 不 会 同时 使 用 该 应 用 程序 工 
作 ， 它 也 是 一 个 多 用 户 系统 。 

对 于 开发 者 而 言 , 云 计算 最 令 人 兴奋 的 一 面 是 它 的 可 扩展 性 。 当 开发 者 在 云 环境 进行 开发 时 ， 
可 以 只 编写 一 个 供 一 两 个 人 使 用 的 简单 程序 , 然后 ,甚至 无 需 改变 任何 一 行 代 码 , 就 可 以 扩展 到 
支持 数 百 万 用 户 。 程 序 本 身 是 与 使 用 规模 无 关 的 , 开发 者 编写 的 应 用 程序 , 被 几 十 个 用 户 使 用 和 
被 上 百 万 用 户 使 用 效果 是 一 样 的 。 随 着 用 户 的 增加 , 开发 者 所 需要 的 只 是 购买 更 多 的 资源 ， 让 程 
序 仍然 可 以 正常 工作 。 开 发 者 可 以 从 运行 在 云 中 的 一 台 服 务 器 上 的 简单 程序 开始 , 通过 增加 资源 
而 扩展 到 支持 数 百 万 用 户 。 





































































































































































































1.1.3 云 计 算 与 客户 /服务 器 计算 


在 很 多 方面 ， 基 于 云 的 软件 开发 的 基本 方式 和 客户 /服务 器 计算 编程 类 似 。 两 者 都 是 基于 同 
样 的 思想 : 应 用 程序 并 不 真正 运行 在 用 户 自己 的 计算 机 上 。 用户 的 计算 机 提供 了 访问 应 用 程序 的 
窗口 , 但 是 , 并 不 直接 运行 应 用 程序 本 身 ， 用 户 在 自己 的 计算 机 上 所 需 做 的 全 部 工作 只 是 运行 某 
种 用 户 界 面 。 真正 的 程序 运行 于 其 他 地 方 被 称 为 服务 器 的 计算 机 上 。 之 所 以 要 使 用 服务 器 ,归根 
结 底 都 是 因为 用 户 的 本 地 计算 机 没有 运行 该 程序 所 需 的 资源 ， 而 在 其 他 地 方 更 容易 获得 这 些 资 
源 ， 从 而 能 够 更 便宜 、 更 快速 、 更 方便 地 运行 该 程序 。 

云 开 发 和 客户 /服务 器 开发 的 最 大 区 别 在 于 用 户 知道 的 范围 不 同 。 在 传统 的 客户 端 -服务 器 系 
统 中 , 用 户 可 能 把 一 台 特 定 的 计算 机 作为 服务 器 ,程序 就 运行 在 该 服务 器 上 。 这 人 台 服 务 器 可 能 不 
在 用 户 面 前 的 办 公 桌 上 , 但 是 用 户 知道 它 在 哪里 。 例如, 我 在 大 学 时 使 用 过 的 第 一 台大 型 机 是 名 
为 “Gold” 的 VAX 11/780， 它 位 于 希 尔 中 心 的 罗 格 斯 大 学 计算 实验 室 。 在 亲眼 看 到 它 之 前 ， 至 少 
一 年 的 时 间 里 , 我 几乎 每 天 都 在 使 用 它 。 除 Gold 外 ， 这 个 数据 中 心 至 少 还 有 三 十 台 计 算 机 : 若干 
台 DEC 20， 几 台 Pyramid， 一 台 S/390， 还 有 一 群 Sun 服 务 器 。 但 是 在 这 些 机 器 中 ,我 只 使 用 Gold。 




















































































































我 编写 的 每 个 程序 ， 都 专用 于 在 Gold 机 上 运行 ， 而 且 这 也 是 我 能 够 运行 程序 的 唯一 的 地 方 。 

而 在 云 中 ,用 户 却 并 不 限定 在 一 台 特 定 的 服务 器 上 。 用 户 拥有 计算 资源 , 但 那 是 有 人 租 给 他 
一 定数 量 的 计算 资源 ,这 些 资源 位 于 某 个 地 方 的 一 些 机 器 上 ,用户 并 不 知道 它们 在 哪里 ， 也 不 知 
道 它 们 是 什么 类 型 的 计算 机 。 这 些 机 需 可 能 是 两 个 大 型 机 ， 每 个 有 32 个 处 理 需 以 及 64GB 的 内 存 ， 
也 可 能 是 64 个 极 小 的 单 处 理 器 机 器 ， 每 个 只 有 2GB 的 内 存 。 运 行 这 些 程序 的 计算 机 可 能 自身 带 有 
超大 容量 的 硬盘 ,也 可 能 是 无 盘 工 作 站 ， 需 要 访问 专用 存储 服务 器 上 的 存储 空间 。 这 些 对 你 这 个 
云 用 户 并 不 重要 。 你 已 经 得 到 了 购买 的 资源 ,而 且 这 些 资源 就 是 你 所 需要 的 , 它们 的 位 置 着 实 无 
关 紧 要 。 


1.1.4” 何 时 用 云 开发 


综 上 所 述 , 现在 我 们 知道 了 什么 是 云 。 这 是 一 个 思考 计算 模式 的 革命 性 方式 : 云 是 一 种 由 服 
务 右 所 组 成 的 世界 ， 用 户 可 以 在 其 上 构建 应 用 程序 ; 云 也 是 一 种 由 服务 所 组 成 的 世界 ， 用 户 可 以 
构建 这 些 服务 ， 也 可 以 使 用 这 些 服务 构建 其 他 的 东西 。 现 在 的 问题 是 ， 何 时 该 用 云 ? 
用 户 可 以 编写 几乎 任何 一 个 想 在 云 中 实现 的 应 用 程序 。 事实 上 , 不 少 人 坚信 , 一 切 尽 在 云 中 ， 
不 再 需要 为 独立 的 个 人 计算 机 再 开发 什么 应 用 程序 。 我 还 没有 那么 乐观 ， 诚 然 ， 许 多 应 用 程序 
非常 适合 放 在 云 里 , 但 这 并 不 意味 着 云 这 个 平台 就 能 完美 地 容纳 一 切 。 用 户 当 然 可 以 在 云 中 构建 
任何 应 用 程序 用 作 服 务 , 但 是 ， 有 时 这 样 做 要 比 开 发 一 个 独立 运行 的 应 用 程序 困难 得 
在 云 中 构建 以 下 3 种 应 用 程序 是 合乎 情理 的 。 
口 协作 型 应 用 程序 
如 果 用 户 正在 构建 的 应 用 程序 将 被 很 多 一 起 工作 的 团队 所 使 用 ， 需 要 进行 数据 共享 、 交 
流 或 合作 ， 那 么 用 户 确实 应 该 在 云 中 构建 此 应 用 程序 。 协 作 是 云 的 原生 态 。 
口 服务 
问 一 问 “ 这 个 应 用 程序 是 干什么 用 的 ? ”， 如 果 最 自然 的 答案 听 起 来 就 像 是 一 种 服务 ， 那 
么 就 该 考虑 云 应 用 。 应 用 程序 和 服务 之 间 的 区 别 是 微妙 的 ， 我们 可 以 把 几乎 所 有 的 东西 
描述 为 服务 。 这 里 的 关键 问题 是 ， 什 么 是 它 最 自然 的 描述 。 如 果 我 们 想 要 描述 的 是 桌面 
版 的 iTunes 应 用 程序 ,我 们 可 以 说 :“ 它 可 以 让 人 们 管理 自己 的 音乐 收藏 。 这 上 听 起 来 确实 
像 是 服务 。 但 是 ， 这 一 描述 遗漏 了 iTunes 桌 面 应 用 程序 的 关键 属性 : 它 管 理 用 户 计算 机 上 
的 音乐 文件 , 并 可 以 通过 串 行 电缆 与 iPod 上 的 音乐 文件 同步 。 很 显然 , 后面 的 描述 方式 意 
味 着 它 是 一 个 桌面 应 用 程序 ， 而 不 是 云 应 用 程序 。 
男 一 方面 ， 如 果 你 看 一 下 类 似 于 eMusic 的 应 用 , 你 会 得 出 不 同 的 结论 。eMusic 是 一 个 以 订 
阅 为 基础 的 网 站 ,用 户 可 以 浏览 一 个 巨大 的 音乐 库 ,然后 每 月 购买 一 定数 量 的 歌曲 ,eMusic 
显然 是 一 个 服务 : 它 允 许 人 们 在 成 千 上 万 的 音乐 曲目 中 进行 搜索 ， 为 他 们 提供 各 种 功能 ， 
如 听取 音乐 片段 、 阅 读 各 种 评论 、 发 表 对 所 听 过 的 音乐 的 评价 、 根 据 用 户 个 人 喜好 推荐 
新 音乐 ， 并 最 终 选 择 购买 的 东西 。 这 显然 是 一 种 服务 ， 放 在 云 中 合乎 情理 。 
口 大 型 计算 
你 的 应 用 程序 是 否 需 要 执行 海量 的 计算 ,但 你 却 无 法 承担 购买 专用 计算 机 的 费用 ? 如果 













































































































































































































































































是 这 样 ， 那 么 你 可 以 通过 云 计算 来 购买 服务 器 “农场 ”的 时 间 来 运行 你 的 应 用 程序 ， 这 
种 方式 经 济 实惠 。 对 于 像 遗 传 学 研究 人 员 这 些 人 来 说 ， 这 真是 棒 极 了 ， 因 为 他 们 需要 执 
行 海量 的 计算 ， 却 没有 资金 或 其 他 资源 来 为 自己 建立 一 个 专用 的 数据 中 心 。 于 是 ， 他 们 
可 以 购买 商业 数据 中 心 的 机 时 ， 与 许多 其 他 用 户 以 共享 的 方式 使 用 这 些 数据 中 心 。 


1.2 云 计 算 编 程 系统 


在 云 中 进行 编程 的 方式 有 多 种 。 在 真正 开始 编写 程序 之 前 ， 先 快速 浏览 几 个 例子 , 简单 了 解 
一 下 几 种 可 行 方案 。 

1. Amazon EC2 

Amazon 提 供 了 各 种 基于 云 的 服务 。 他 们 的 主要 编程 工具 被 称 为 BC2， 即 弹性 计算 云 (Elastic 
Computing Cloud )。 

事实 上 ，EC2 包 括 一 系列 相关 服务 。 我 们 可 以 拿 App Engine 做 个 对 比 。App Engine 提 供 的 是 
一 个 单一 的 、 功 能 极为 集中 的 API 套 件 ， 而 EC2 完 全 不 管 具 体 用 什么 编程 API。EC2 提 供 了 数 百 种 
不 同 环境 : 用 户 可 以 使 用 Linux、Solaris 或 Windows 服 务 右 来 运行 其 应 用 程序 ， 可 以 使 用 DB2、 
Informix、MySQL、SQL Server 或 Oracle 来 存储 其 数据 ; 可 以 使 用 Perl、Python 、Ruby 、Java 、C++ 
或 C# 来 实现 其 代码 ; 可 以 使 用 [BM 的 WebSphere 或 Mash、Apache JBoss、Oracle WebLogic 或 微 
软 的 HS 来 运行 其 程序 。 根 据 用 户 喜 欢 的 每 种 组 合 ， 以 及 计划 使 用 的 每 种 资源 (存储 空间 、CPU、 
网 络 带 宽 ) 数量 ,成 本 不 尽 相 同 ， 既 有 低廉 的 CPU 小 时 0.10 美 元 和 每 GB 带宽 0.10 美 元 ， 又 有 高 端 
的 每 CPU 小 时 0.74 美 元 。 

2. Amazon S3 

Amazon 还 提供 了 另 一 种 极为 有 趣 的 云 服务 ， 它 与 大 多 数 云 服务 有 很 大 不 同 。 它 是 一 个 纯粹 
的 存储 系统 ， 名 为 S3， 即 简单 存储 服务 ( Simple Storage Service )。S3 既 不 运行 程序 ， 也 不 提供 任 
何 文件 系统 ， 更 不 提供 任何 索引 ， 它 只 是 一 个 纯粹 的 块 存储 ， 可 以 给 用 户 分 配 一 个 存储 块 ， 存储 
块 拥有 一 个 唯一 的 标识 符 ， 然 后 用 户 就 可 以 使 用 该 标识 符 对 此 块 进行 读 取 和 写 入 。 

人 们 已 经 创建 了 使 用 S3 存 储 方式 的 各 种 系统 ,如 基于 网 络 的 文件 系统 、 本 地 操作 系统 的 文件 
系统 、 数 据 库 系 统 以 及 表 存 储 系 统 。 作 为 以 云 资源 为 基础 的 范例 ，S3 是 一 个 非常 好 的 例子 : 存储 
所 涉及 的 计算 与 实际 的 数据 存储 本 身 完全 分 离 。 用 户 需 要 存储 空间 时 , 可 从 S3 购 买 一 定 的 存储 空 
间 ; 需要 计算 时 ， 可 购买 EC2 的 资源 。 

S3 是 一 个 真正 令 人 着 迷 的 系统 。 它 非常 专 一 ， 只 做 存储 这 一 件 事 情 ， 并 且 采 用 了 一 种 极其 狭 罕 
的 方式 。 但 其 重要 意义 在 于 ， 这 正 是 云 的 真 诺 。S3 是 一 个 绝对 专 一 的 服务 ， 它 只 为 用 户 存 储 数 据 。 

S3 的 收费 基于 两 个 标准 : 用 户 存储 数据 量 的 大 小 ,用 户 存 储 和 读 取 数据 所 使 用 的 网 络 带宽 。 
Amazon 目 前 的 收费 为 ， 每 月 每 GB 存储 空间 0.15 美 元 ， 带 宽 资源 大 约 是 ， 上 传 每 GB 为 0.10 美 元 ， 
下 载 每 GB 为 0.17 美 元 。 

男 有 相关 消息 称 ，Google 提 供 了 一 个 非常 相似 的 云 服务 ， 名 为 “Google 开 发 者 存储 "， 该 服 
务 在 Google 云 中 复制 了 S3 的 基本 特性 。 
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3. IBM 按 需 计算 

IBM 提 供 了 一 个 云 服务 平台 ， 该 平台 基于 IBM 的 网 络 服务 开发 套件 ， 采 用 WebSphere 、DB2 
和 Lotus 协 作 工 具 。 这 个 环境 与 EC2 上 基于 IBM 的 环境 相同 ,但 它 运 行 于 IBM 的 数据 中 心 ， 而 不 是 
在 Amazon 的 数据 中 心 。 

4. Microsoft Azure 

Microsoft 已 经 开发 和 部 署 了 一 个 名 为 Azure 的 云 平台 。 它 是 一 个 基于 Windows 的 平台 ， 采 用 
的 是 标准 的 网 络 服务 技术 (如 SOAP 、REST 、Servlet 和 ASP ) 和 微软 专 有 API ( 如 Silverlight ) 的 
组 合 。 这 种 组 合 的 结果 是 , 用 户 可 以 创建 一 个 异常 强大 的 应 用 程序 , 非常 像 标准 的 桌面 应 用 程序 。 
但 其 缺点 是 ， 由 于 该 应 用 程序 与 Windows 平 台 紧 密 联系 在 一 起 ， 所 以 ,应 用 的 客户 端 主要 运行 在 
Windows 平 台 上 。 虽 然 有 其 他 平台 的 Silverlight 实 现 ， 但 是 ， 这 类 应 用 往往 只 有 在 Windows 平 台 上 
才 是 最 可 靠 的 ， 只 有 在 Internet Explorer 中 才 是 功能 齐全 的 。 

因此 ， 这 就 是 云 。 既 然 知 道 了 云 的 概念 ， 下 面 我 们 就 开始 学 习 如 何在 云 中 构建 应 用 程序 。 
Google 已 经 组 建 了 一 个 很 了 不 起 的 平台 ， 名 为 App Engine， 可 以 供用 户 构建 和 运行 自己 的 云 应 
用 程序 。 

在 本 书 的 其 余部 分 , 我 们 还 将 详细 了 解 一 些 用 于 构建 基于 云 的 网 络 应 用 程序 的 关键 部 件 。 我 
们 将 开始 使 用 Python， 用 Python 来 学 习 基 础 知识 非常 棒 ， 它 可 以 让 读者 看 到 发 生 了 什么 事情 ， 并 
且 很 容易 快速 尝试 不 同 的 方法 ， 看 看 会 发 生 什 么 。 

我 们 将 从 基本 的 构建 块 ( 如 HTTP、 服 务 和 处 理 程序 ) 开 始 , 贯穿 读者 用 Python 构建 Google App 
Engine 应 用 程序 所 需 的 各 项 技术 的 整个 过 程 。 然 后 ， 我 们 将 了 解 如 何 利 用 App Engine 的 数据 存储 
服务 ， 在 云 中 实现 数据 持久 化 存储 。 接 下 来 我们 再 了 解 如 何 采 用 HTTP、CSS 和 AJAX 为 应 用 程 
序 构建 用 户 界 面 。 

然后 ， 我 们 将 暂时 将 内 容 从 Python 转移 到 Java 上 来 。 在 我 看 来 ， 用 Java 构 建 复杂 的 应 用 程 
序 会 更 加 方便 。 这 并 不 是 说 Python 不 能 或 不 应 该 用 于 高 级 的 App Engine 开 发 ， 只 是 我 倾向 于 使 
用 Java。 并 且 App Engine 提 供 了 一 个 精彩 绝伦 的 架构 GWT， 它 从 基于 网 络 的 云 应 用 中 抽象 出 了 
大 部 分 的 样板 基础 工作 ,使 得 用 户 可 以 把 重点 放 在 其 感 兴趣 的 部 分 。 我 们 将 花 一 些 时 间 来 学 习 
如 何 使 用 GWT 创 建 漂亮 的 用 户 界面 , 以 及 如 何 使 用 GWT 的 远程 过 程 调用 服务 来 实现 AJAX 风 格 
的 通信 。 

最 后 将 介绍 真实 网 络 开 发 中 最 复杂 的 方面 。 我 们 将 了 解 以 下 有 关 细 节 : 如 何 使 用 App Engine 
的 数据 仓库 服务 来 制作 复杂 系统 ， 如 何 使 用 类 似 cron 的 机 制 来 实现 服务 器 端的 处 理 和 运算 ， 以 及 
如 何 将 安全 性 和 身份 认证 整合 到 用 户 的 App Engine 应 用 程序 中 。 

在 下 一 章 中 ， 我 们 就 将 正式 开始 学 习 App Engine， 届 时 将 首先 介绍 如 何 建立 一 个 App Engine 
的 账户 ， 然 后 是 如 何 设置 用 户 计算 机 上 的 软件 ， 用 来 构建 、 测 试 和 部 署 采用 Python 编写 的 App 
Engine 应 用 程序 。 
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在 这 一 章 中 , 我 们 将 初步 了 解 并 开始 使 用 Google App Engine。 我 们 将 学 习 如 何 完成 如 下 工作 : 
口 设置 Google App Engine 账 户 ; 
口 下 载 并 安装 Google App Engine SDK( 软件 开发 工具 包 ); 
口 创建 一 个 简单 的 Google App Engine 应 用 程序 ; 
口 在 本 地 测试 应 用 程序 ; 
口 在 云 中 部 署 和 监视 ， 人 AB 0 用 程序 。 
这 章 不 是 本 书 中 最 令 人 兴奋 的 章节 ， 但 它 是 开发 者 能 够 进一步 获得 感 兴趣 内 容 的 必 经 之 路 。 
当然 ， Re 














2.1 设置 Google App Engine 账户 


为 了 使 用 Google App Engine 编 写 云 应 用 程序 ， 开 发 者 需要 做 的 第 一 件 事 就 是 开通 一 个 App 
Engine 账 户 。 开 发 者 进行 云 开 发 时 ， 需 要 为 应 用 程序 租用 计算 和 存储 资源 。App Engine 账户 为 开 
发 者 提供 了 一 组 基本 的 免费 资源 ， 以 及 在 需要 时 可 以 购买 更 多 不 同 种 类 资源 的 机 制 。 

创建 一 个 Google App Engine 账 户 是 免费 的 。 一 个 基本 的 、 免 费 的 App Engine 账 户 可 以 供用 户 
运行 10 个 应 用 程序 ， 并 且 具 有 如 下 特点 : 

口 每 天 6.5 小 时 的 CPU 时 间 ; 

口 每 天 10GB 的 上 行 带 宽 和 10GB 的 下 行 带宽 ; 
口 1GB 的 数据 存储 空间 ; 

口 每 天 可 发 送 2000 封 电子 邮件 。 


如 果 开 发 者 有 更 多 需求 ， 可 以 购买 各 种 额外 资源 。 

要 建 Google App Engine 账 户 ， 首 先 要 有 一 个 标准 的 Google 账 户 。 如 果 开 发 者 使 用 了 Gmail 或 
者 iGoogle， 就 已 经 有 了 标准 账户 了 。 如 果 没 有 ， 只 需要 访问 ， 选 择 屏 幕 右 上 角 的 “注册 ”， 然 后 
点 击 “ 现 在 创建 账户 ”的 链接 即 可 。 

创建 好 Google 账 户 之 后 ， 开 发 者 就 可 以 在 浏览 器 中 打开 http:/appengine.google.com ， 开 始 使 
用 Google App Engine 了 。 开 发 者 将 会 看 到 一 个 标准 的 Google 登 录 界 面 ， 然 后 用 其 Google 用 户 名 和 
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密码 登录 即 可 。 第 一 次 进行 该 操作 时 ,开发 者 需要 通过 手机 短信 进行 身份 认证 。 为 了 防止 垃圾 邮 
件 发 送 者 设立 App Engine 账 户 ，Google 设 置 了 使 用 唯一 电话 号 码 注册 的 机 制 。 别 想 蒙 混 过 关 ， 一 
个 电话 号 码 只 能 设置 一 个 App Engine 账 户 一 一 某 号 码 一 旦 被 使 用 ,用 户 便 不 能 再 使 用 该 号 码 创建 
其 他 账户 。 








CPU 时 间 计 算 

开发 者 每 天 可 获得 6.5 小 时 的 免费 CPU 时 间 。 但 是 ， 如 果 开 发 者 购买 了 CPU 时 间 ， 随 
着 工作 的 开展 ， 开 发 者 最 终 使 用 的 可 能 远 不 止 于 此 ， 甚 至 最 终 一 天 使 用 的 CPU 时 间 会 超过 
24 个 小 时 。 在 Google App Engine 中 ， 开 发 者 的 应 用 程序 不 只 在 一 台 服 务 器 上 运行 ， 而 是 运 


行 在 Google 的 数据 中 心 。 每 个 发 来 的 请 求 都 会 被 路 由 到 集群 的 某 台 机 器 上 。 因 为 可 以 有 多 
个 用 户 同 时 访问 开发 者 的 应 用 系统 ， 所 以 ， 应 用 程序 使 用 了 多 人 台 物 理 计算 机 的 CPU 时 间 。 
开发 者 要 为 运行 其 应 用 程序 的 所 有 计算 机 的 CPU 时 间 总 和 付费 。 这 样 一 来 ， 开 发 者 一 天 使 
用 的 CPU 时 间 可 能 不 止 24 小 时 。 





开发 者 填写 完 表 格 后 ， 可 以 在 浏览 右 中 看 到 一 个 新 页 面 ， 要 求 输入 认证 码 。 在 10 分 钟 内 ， 开 
发 者 将 会 收 到 包含 认证 码 的 手机 短信 。 输 入 认证 码 ， 就 可 以 使 用 该 账户 了 。 


2.2 设置 开发 环境 


拥有 Google App Engine 账 户 后 ， 首 先 要 做 的 就 是 创建 一 个 应 用 程序 。 而 自 此 开始 ， 云 过 程 的 
开发 和 通常 的 应 用 程序 开发 已 经 稍 有 不 同 了 。 要 编写 一 个 在 自己 计算 机 上 运行 的 新 程序 , 开发 者 
只 需要 打开 编辑 器 ， 然 后 输入 代码 即 可 。 而 编写 云 应 用 程序 ,开发 者 需要 在 云 服务 器 上 注册 自己 
的 应 用 程序 ， 以 便 为 其 运行 创建 空间 ， 并 获取 在 该 空间 工作 所 需要 的 工具 。 

在 开发 者 下 载 Google App Engine 工 具 之 前 ,要 确保 自己 的 计算 机 上 已 经 安装 了 Python。Python 
语言 现在 处 于 不 稳定 状态 , 不 断 演变 出 被 显著 改写 的 版 本 。 因 此 , 日 常 使 用 中 会 有 多 个 互 不 兼容 
的 Python 版 本 。 对 于 App Engine 而 言 ， 开 发 者 需要 使 用 Python 2.5。 所 以 ， 必 须 确保 安装 的 是 正确 
的 Python 版 本 。 开 发 者 如 何在 不 同 的 操作 系统 上 安装 Python 用 来 开发 App Engine 服 务 ， 不 是 本 市 
讨论 的 内 容 , 但 是 ,如 果 开 发 者 访问 Python 的 主页 http:/python.org ， 就 可 以 找到 最 新 的 安装 指南 。 

开发 者 还 需要 一 个 文本 编辑 器 或 者 IDE 来 编写 代码 。 有 很 多 优秀 的 免费 工具 可 以 使 用 ， 开 发 
者 只 需要 挑选 适合 自己 的 那 一 款 ， 并 确保 将 它 安装 好 即 可 。 

当 开发 者 安装 好 了 编写 Python 程序 所 需 的 工具 后 ， 就 可 以 登录 在 上 一 节 创 建 的 App Engine 账 
户 ， 点 击 “创建 应 用 程序 ”( Create an Application ) 按钮 ， 下 载 Google App Engine Python SDK。 
然后 开发 者 将 看 到 一 个 表单 ， 显 示 的 是 应 用 程序 的 名 称 和 描述 。 该 表单 看 起 来 和 图 2-1 中 的 表单 
类 似 。( 由 于 App Engine 经 常 更 新 ， 所 以 确切 的 表单 可 能 显示 出 来 略 有 不 同 。) 
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ail. 
Google App Engine markcc@gmail.com | My Account | Help | Sign ou 


Create an Application 


Application Identifier: 
makce chatroom-one | .appspot.com (Check Avaliabiity ) Yes "markec-chatroom-one" is availablel 
You can map he appicaton to your own domain bior earn mere 


Application Titie: 





Dispiayed when users access your appication 


Authentication Options (Advanced): Leam more 
Google App Engine providos an AP! for authenticating your users ce choose not io vse this, anyone in the wor 旭 wii be abio iD 


access your appication However, ¥you choose Io uso this, you' nood to spociy now who can sign n ip your appication 
Open to all Google Accounts users (default) 

if your applcasion usos authontication, anyor woo wh ay ad Googie Account may sign in. (This includes al Gmail Accounts, but doos 
“por nc ounts on any Googlo domaim 

Ed 


Terms of Service: 








17.7, The Terms, and your relationship with Google under the Terms, shall be govemed 

by the laws of the State of Califomia without regard to its conflict of laws provisions. You 
and Google agree to submit to the exclusive jurisdiction of the courts located within the 
county of Santa Clara, California to resolve any legal matter arising from the Terms. 
Norwithstanding this, you agree that Google shall still be allowed to apply for injunctive D 
remedics (or an cquivalent type of urgent legal relief) in any jurisdiction. 


区 1 accept these terms. 


Ga Ga 


© 2008 Google | Terms of Service | Privacy Policy | Blog | Discussion Fomnums 











图 2-1 Create an Application 表 单 


为 了 创建 自己 的 应 用 程序 ， 开 发 者 需要 向 Google App Engine 服 务 提 供 一 些 信息 。 

口 应 用 程序 标识 符 
应 用 程序 标识 符 ( Application Identifier ) 是 开发 者 的 应 用 程序 的 唯一 名 称 , 以 区 别 于 任何 
其 他 App Engine 用 户 所 运行 的 任何 一 个 应 用 程序 。 该 名 称 将 作为 访问 该 应 用 程序 的 URL。 
由 于 这 个 属性 不 能 被 开发 者 修改 ， 因 此 务必 谨慎 选择 ! 开发 者 可 以 输入 一 个 名 称 并 点 击 
“检查 是 否 可 用 ”( Check Availability ) 按钮 进行 检查 ， 以 确保 该 名 称 没有 被 其 他 人 使 用 。 
我 建议 开发 者 为 其 应 用 程序 名 称 选择 一 个 私有 前 级 ， 这 样 做 容易 避免 与 其 他 人 的 应 用 程 
序 发 生 名 字 冲 突 , 并 且 在 App Engine 程 序 世 界 里 , 可 以 给 开发 者 编写 的 一 系列 应 用 程序 赋 
予 一 个 通用 的 标识 。 为 本 书 创建 的 所 有 应 用 程序 ， 我 都 使 用 了 markcc 前 级 。 对 于 后 文 将 
遇 到 的 示例 应 用 程序 ， 我 选用 的 名 称 为 markcc-chatroom-one， 因 此 ， 该 示例 应 用 程序 
的 URL 是 http://markcc-chatroom-one.appspot.com。 

口 应 用 程序 标题 
这 是 所 有 应 用 程序 的 用 户 都 会 看 到 的 程序 名 称 ， 并 且 该 名 称 会 在 登录 页 面 显示 。 在 示例 
中 ， 我 使 用 了 MarkCC’s Example Chatroom ( MarkCC 示 例 聊天 室 ) 作为 应 用 程序 标题 
( Application Title )。 开 发 者 可 以 从 控制 面板 随时 修改 应 用 程序 的 标题 。 
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口 安全 和 身份 认证 设置 
开发 者 可 以 为 应 用 程序 进行 初始 的 安全 性 和 身份 认证 设置 。 这 个 话题 在 这 里 就 不 探讨 了 ， 
我 们 将 在 第 17 章 中 再 讨论 。 

口 服务 条 款 
开发 者 必须 先 接受 Google 的 服务 条 款 ( Terms of Service )， 才 能 使 用 Google App Engine 创 
建 应 用 程序 。 请 开发 者 花 点 时 间 通 读 这 些 条 款 ， 了 解 自己 所 做 的 承诺 以 及 Google 给 开发 
人 员 提 供 的 承诺 ， 然 后 点 击 复 选 框 ， 表 明 接 受 这 些 条 款 。 

填写 完 该 表格 ， 单 击 Save 按 钮 ，Google App Engine 就 会 创建 加 新 的 应 用 程序 架构 。 开 发 者 保 


存 了 初始 的 应 用 程序 描述 后 ， 会 看 到 一 个 控制 面板 ， 该 面板 用 于 构建 和 监视 应 用 程序 ( 图 2-2 )。 






































Application: markcc-chatroom-ore No version deployed! < Show All Apolications 


Main A You need to upload and deploy an application before you can make Web history. 
Dashboard Read about using appcfg.py to upload and deploy one. 


Charts 


No Data Available 


Billing Status: Free - Settings Quotas reset every 24 hours. Next reset: 12 
Resource Usage 


Current Load Errors - 

Resources URI Requests Avg CPU (API) % CPU % 
lst 12 vs hast last 12 hes URI Count Errors 

Documentation 训 











图 2-2”Google App Engine 控 制 面板 


看 到 应 用 程序 控制 面板 , 开发 者 就 可 以 准备 开始 编程 了 。 不 过 要 注意 , 云 程 序 的 开发 和 其 他 
的 程序 开发 不 同 。 开 发 者 不 能 编辑 Google App Engine 服 务 器 上 的 文件 , 需要 在 本 地 编写 程序 ， 然 
后 使 用 一 个 管理 脚本 将 本 地 程序 传送 到 App Engine 环 境 中 去 运行 。 

下 一 步 就 是 获取 工具 。 在 控制 面板 的 左下 角 ， 开 发 者 会 看 到 一 个 标记 为 “资源 ”的 区 域 。 这 
个 区 域 包含 了 开发 者 学 习 和 使 用 Google App Engine 时 需要 的 软件 、 论 坛 、 文 档 的 链接 。 现 在 ， 点 
击 “ 下 载 ” 链 接 ， 为 Python 下 载 合 适 的 App Engine SDK 版 本 。 下 载 完成 后 ， 紧 接着 进行 安装 。 根 
据 自 己 使 用 操作 系统 ,安装 过 程 会 略 有 不 同 : 对 于 Windows 或 Macintosh 而 言 ， 下 载 的 内 容 已 包含 
一 个 自动 安装 程序 ， 只 需 运 行 它 ， 就 能 完成 安装 工作 ; 如 果 开 发 者 使 用 的 是 Linux， 下 载 的 内 容 
是 一 个 zip 压 缩 文件 ， 需 要 在 恰当 的 地 方 解 压 该 文件 。 

如 果 使 用 的 是 Windows 或 者 MacOS， 就 可 以 准备 开始 使 用 了 ; 如 果 是 Linux， 则 需要 将 解压 
SDK 压 缩 文 件 的 目录 添加 到 相关 路 径 中 。 
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在 SDK 中 ， 开 发 者 会 使 用 到 以 下 两 个 主要 程序 。 

口 dev_appserver.py: 该 程序 运行 了 一 个 模拟 的 Google App Engine 环 境 ， 开 发 者 可 以 使 用 
该 环境 在 本 地 计算 机 测试 其 应 用 程序 。 

口 appcfg.py: 该 程序 用 于 在 使 用 Google App Engine 的 云 中 上 传 和 配置 开发 者 的 应 用 程序 。 

















2.3 开始 App Engine 中 的 Python 编程 


现在 ， 我 们 可 以 开始 编程 了 ! 

Python App Engine 的 核心 非常 简单 。 主 引擎 是 一 个 轻 量 级 、 安 全 的 CGI 执行 程序 。CGI 是 执 
行程 序 响 应 HTTP 请 求 的 最 古老 的 接口 之 一 。 Google App Engine 本 质 上 就 是 纯粹 的 CGI, 其 最 大 的 
优势 在 于 ， 开 发 者 曾 用 Python 编写 过 的 任何 CGI 脚本 ， 都 可 以 应 用 于 Google App Engine。 任 何 为 
CGI 脚本 编写 的 框架 和 Python 库 都 能 用 于 Google Apple Engine 一 一 开发 者 上 传 应 用 程序 代码 时 只 
需 包含 所 用 的 框架 / 库 文 件 即 可 。 


为 什么 从 Python 起 步 ? 


稍 后 还 会 就 该 问题 给 出 更 多 解释 ， 但 我 并 不 是 一 个 超级 Python 迷 。 我 们 从 Python 开 
始 学 习 有 若干 原因 。 

首先 , Python 是 一 门 非常 友好 的 语言 , 开发 者 使 用 少量 的 代码 就 可 以 完成 大 量 的 工作 。 
我 们 只 用 几 行 代码 就 可 以 编写 出 App Engine 应 用 程序 。Python 需要 的 基础 设施 非常 少 。 当 
开发 者 想 学 习 如 何 进行 云 开发 时 ，Python 就 是 个 极 好 的 开始 方式 。 

其 次 ， 我 不 应 该 根据 自己 的 爱好 来 规定 开发 者 应 该 如 何 构建 自己 的 应 用 程序 。Python 
是 一 门 非常 强大 、 灵 活 的 语言 ， 并 且 很 好 地 得 到 了 App Engine 的 支持 。 如 果 你 是 Python 
爱好 者 ， 那 么 读 完 这 本 书 ， 你 应 该 能 够 用 Python 构建 自己 的 App Engine 应 用 程序 了 。 

再 次 ， 我 们 将 要 学 习 一 些 工具 ， 如 GWT， 它 们 生成 了 大 量 代码 ， 为 我 们 的 云 应 用 程 
序 处 理 客户 端 - 服 务 器 的 底层 交互 机 制 。 对 于 复杂 的 应 用 程序 开发 ， 这 样 做 可 以 为 我 们 节 
省 大 量 的 时 间 。 但 是 ， 了 解 幕后 原理 很 重要 。 

Python 为 我 们 提供 了 一 种 探索 云 应 用 程序 原始 构造 的 良好 方法 。 我 们 能 够 看 到 每 个 技 
术 细 节 ， 将 其 构建 起 来 ， 并 了 解 它 是 如 何 工作 的 。 当 讲 到 GWT 时 ， 我 们 就 更 容易 理解 云 
应 用 程序 是 怎么 构造 的 了 。 

如 果 开 发 者 喜欢 用 Python 进行 云 编程 ,那么 你 在 本 书 中 将 会 学 到 足够 多 的 知识 ， 能 用 
其 进行 云 编程 。 但 是 , 即使 开发 者 不 使 用 Python 编写 云 应 用 程序 , 不 管 准备 使 用 哪 种 语言 ， 
花 些 时 间 通 过 Python 探索 云 应 用 程序 的 基本 技术 也 会 有 助 于 开发 者 理解 和 调试 真实 的 应 
用 程序 。 
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使 用 Google App Engine 工 作 最 简单 的 方法 是 应 用 它 自 带 的 框架 , 即 webapp。webapp 是 一 个 非 
常 精致 、 强 大 的 框架 ， 使 用 起 来 十 分 简单 、 友 好 。 

此 外 ，Google App Engine 给 开发 者 提供 了 对 Google 服 务 的 访问 权限 ， 如 登录 、 数 据 存储 、 安 
全 、 身 份 认证 , 以 及 应 用 程序 内 的 付费 功能 。 在 本 书 中 , 我 们 将 重点 放 在 webapp 框 架 的 使 用 上 
但 是 一 旦 开发 者 知道 如 何 使 用 App Engine 工 作 并 执行 程序 ， 就 可 以 使 用 这 些 服务 以 及 其 他 框架 编 
写 App Engine 应 用 程序 了 。 

本 书 的 大 部 分 内 容 将 围绕 一 个 聊天 室 应 用 展开 。 但 在 开发 聊天 室 应 用 之 前 ， 我 们 先 开发 个 云 版 本 
的 “Hello, World.”。 这 是 个 运行 在 云 服 务 器 端的 简单 程序 , 会 生成 一 个 显示 在 用 户 浏览 器 中 的 欢迎 页 面 。 

为 云 应 用 程序 通常 使 用 网 络 浏览 器 作为 其 用 户 界面 , 所 以 我 们 要 开发 的 应 用 程序 必须 生成 
HTML 格 式 ， 而 不 仅仅 是 纯 文 本 。 无 论 何 时 生成 输出 ， 首 先 需 要 包含 一 个 MIME 头 ，MIME 头 只 
有 一 行 ， 用 于 指定 后 续 内 容 的 格式 。 对 HTML 而 言 ， 后 续 内 容 的 类 型 为 text/htm1]。 

Google App Engine SDK 和 希望 开发 者 所 有 的 应 用 程序 文件 存储 在 一 个 目录 层次 结构 中 。 我 们 
为 第 一 个 程序 创建 一 个 名 为 chatone 的 目录 。 在 该 目录 中 ， 我 们 将 在 名 为 chat.py 的 文件 中 编写 
这 个 微型 欢迎 程序 : 







































































chatone/chat.py 


import datetime 


print 'Content-Type: text/htmi' 

print "" 

print '<htm]>" 

print '<head>" 

print '<title>Welcome to MarkCC\'s chat service</title>" 
print '</head>" 

print '<body>" 

print '<hl>Welcome to MarkCC\'s chat service</h1>"' 
print "" 

print 'Current time is: %s' % (datetime.datetime.now()) 
print '</body>" 

print '</html>" 


为 了 能 够 运行 该 程序 , 我们 需要 告诉 Google App Engine 它 是 用 什么 语言 编写 的 , 它 需 要 什么 
资源 ， 代 码 在 哪里 ， 以 及 如 何 用 代码 实现 向 服务 器 发 送 请 求 。 
在 Google App Engine 中 ， 我 们 通过 编写 app.yam] 文 件 完成 该 工作 : 





chatone/app.yaml 


application: markcc-chatroom-one 
version: 1 

runtime: python 

api_version: 1 


handlers: 
- Url: /.* 
script: chat.py 
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文件 app.yam] 总 是 以 一 个 文件 头 开 始 ， 该 头 部 的 字段 描述 如 下 所 述 。 
口 application 
我 们 正在 构建 的 应 用 程序 的 名 称 。 该 名 称 必 须 与 开发 者 创建 应 用 程序 的 控制 面板 时 给 出 
的 名 称 完全 匹配 。 
口 version 
一 个 字符 串 ， 用 来 声明 我 们 的 应 用 程序 的 版 本 。 该 字段 主要 是 给 我 们 提供 信息 ， 以 便 可 
以 进行 一 些 操作 ， 如 查询 服务 器 以 得 到 正在 运行 的 应 用 程序 的 版 本 ,或 者 识别 引起 某 些 
错误 的 代码 版 本 。 开 发 者 可 以 为 该 字段 配置 任意 的 字符 串 标 识 。 
口 runtime 
我 们 编写 该 程序 所 使 用 的 语言 : Java 或 Python。 
文件 头 之 后 ， 我 们 需要 编写 一 个 处 理 程序 子 名 列表。 当 Google App Engine 服 务 器 收 到 一 个 发 来 的 
HTTP 请 求 时 , 通过 该 列表 的 描述 , 决定 其 应 该 执行 什么 操作 。 服 务 器 会 把 HTTP 请 求 路 由 到 我 们 所 编写 
的 脚本 上 。App.yam] 文 件 中 的 处 理 程序 子 句 就 是 用 来 通知 服务 器 哪些 请 求 会 路 由 到 哪些 Python 脚本 的 。 
在 每 个 处 理 程序 子 句 中 ,ur1 模 式 使 用 正则 表达 式 声明 ， 紧 接着 是 描述 收 到 匹配 该 模式 的 请 求 时 应 该 执 
行 的 操作 的 子 句 。 在 我 们 的 例子 中 ， 只 有 一 个 处 理 程序 。 我 们 的 应 用 程序 接收 到 任何 请 求 都 会 通过 运 
行 欢迎 脚本 来 进行 响应 ， 所 以 ur1 的 模式 是 /.*， 表 示 匹 配 任意 请 求 。 无 论 何 时 收 到 一 个 请 求 ， 我 们 都 
希望 运行 欢迎 脚本 。 所 以 ， 代 码 的 操作 为 script: chat.py， 表 示 “ 运 行 名 为 chat.py 的 脚本 ”。 
为 了 测试 这 个 应 用 程序 ， 首 先 使 用 dev_appserver .py 在 本 地 运行 该 程序 : 
$1s 
Chatone 
$ 1s chatone 
app.yaml chat.py 
$ dev_appserver.py chatone 
INFO 2009-06-18 23:13:31,872 appengine_rpc.py:157]Server:appengine.google.com 
INFO 2009-06-18 23:13:31,880 appcfg.py:320] Checking for updates to the SDK. 
INFO 2009-06-18 23:13:31,994 appcfg.py:334] The SDK is up to date. 
WARNING 2009-06-18 23:13:31,994 datastore_file_stub.py:404] Could not read \ 
datastore data from /tmp/dev_appserver.datastore 
WARNING 2009-06-18 23:13:31,994 datastore_file_stub.py:404] Could not read \ 
datastore data from /tmp/dev_appserver.datastore.history 


INFO 2009-06-18 23:13:32,058 dev_appserver_main.py:463] Running application\ 
markcc-chat-one on port 8080: http://localhost:8080 


随 着 应 用 程序 的 本 地 运行 ,我们 可 以 使 用 网 络 浏览 器 进行 测试 。 查 看 运行 dev_appserver.py 
时 输出 的 最 后 一 行 一 一 该 行 提 供 了 本 次 会 话 的 URI 一 一 本 示例 中 是 http:/localhost:8080。 如 果 我 们 在 
浏览 器 打开 该 URL， 可 以 看 到 类 似 的 内 容 : 


Welcome to MarkCC's chat service 











































































































Current time is: 2009-06-18 22:30:47.345731 





既然 我 们 知道 该 程序 可 以 运行 ， 现 在 就 可 以 运行 appcfg.py 命 令 将 其 部 署 到 云 服 务 器 中 。 
appcfg.py 是 开发 人 员 访 问 Google App Engine 的 主要 接口 ， 所 以 它 支持 很 多 不 同 的 应 用 程序 。 要 
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发 送 代码 到 服务 器 ， 可 使 用 appcfg.py 的 update 命 令 。 


$ appcfg.py update chatone 

Scanning files on local disk. 

Initiating update. 

Cloning 1 application file. 

Uploading 1 files. 

Deploying new version. 

Checking if new version is ready to serve. 

Will check again in 1 seconds. 

Checking if new version is ready to serve. 

Closing update: new version is ready to start serving. 


现在 ,代码 就 部 署 在 服务 器 上 了 。 开 发 者 可 以 通过 http://your-app-name.appspot.com 网 址 访问 
该 程序 。 

即使 在 这 第 一 个 例子 中 , 也 可 以 开始 看 出 Google App Engine 编 程 的 基本 风格 。 我 们 没有 使 用 
任何 webapp 框 架 的 内 容 ， 但 仍然 体现 了 其 基本 概念 : app.yam] 文 件 指出 了 收 到 的 请 求 是 如 何 被 
路 由 到 组 成 我 们 程序 的 脚本 中 的 , 并 指出 我 们 的 应 用 程序 和 用 户 通信 的 方法 是 在 用 户 浏览 器 中 生 
成 HTML 内容。 

上 述 琐碎 方法 的 问题 在 于 , 生成 MIME 头 以 及 HTML 页 面 结构 这 些 事情 都 是 通过 手工 完成 的 。 
手工 完成 这 些 工 作 非 常 繁琐 ， 而 且 极 容易 出 错 。 当 开发 者 开始 编写 交互 式 应 用 ,解析 收 到 的 请 求 
输入 时 ,这 种 方式 的 弊端 就 更 加 严重 。webapp 框 架 提 供 了 处 理 基本 HTTP 请 求 / 啊 应 循环 的 基础 架 
构 , 能 解析 收 到 的 请 求 , 生成 必要 的 文件 头 , 管理 与 网 络 服务 器 的 通信 以 发 送 响应 。 另 外 , webapp 
提供 了 一 组 模板 处 理 右 供 你 使 用 , 使 得 开发 者 可 以 创建 响应 的 架构 , 而 无 须 输 出 整个 HTML 结构。 
只 是 现在 ， 我 们 的 HIML 足 够 简单 ， 不 需要 使 用 模板 功能 ， 但 在 第 6 章 中 ， 我 们 会 详细 了 解 模 板 
的 功能 。 

下 面 是 使 用 基本 webapp 架 构 的 欢迎 页 面 应 用 程序 的 版 本 。 







































































chatone/chatonewa.py 


OO from google.appengine.ext import webapp 
from google.appengine.ext.webapp.util import run_wsgi_app 
import datetime 


@ class WelcomePage(webapp.RequestHandler): 
© def get(self): 
@ self.response.headers["Content-Type"] = "text/html" 
© self.response.out.write( 
"""<htm]l> 
<head> 
<title>Welcome to MarkCC's chat service</title> 
</head> 
<body> 
<hi>Welcome to MarkCC's chat service</h1l> 
<p> The current time is: %s</p> 
</body> 
</htm]l> 
""" % (datetime.datetime.now())) 
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© chatapp = webapp.wSGIApplication([('/', WelcomePage)]) 


@ def main(): 
run_wsgi_app (chatapp) 


if name =="_ _main, 
main(C) 


我 们 快速 浏览 一 下 ， 看 看 webapp 各 部 分 代表 什么 意思 。 

@@ 首先 ， 我 们 需要 引入 将 要 使 用 的 webapp 框 架 的 各 个 部 分 。 对 这 个 程序 来 讲 ， 我 们 使 用 了 
两 个 基本 的 webapp 构 建 块 : webapp 模 块 本 身 和 一 个 名 为 run_wsgi_app 的 webapp 函 数 。 

@ 接 下 来 ,我们 创建 一 个 webapp 的 RequestHand1er。webapp 理 解 HITP 是 如 何 工 作 的 ， 并 
提供 了 用 于 使 用 HTTP 协 议 的 所 有 基本 元 素 的 实用 工具 类 。 云 应 用 程序 中 的 基本 操作 就 是 
响应 用 户 发 出 的 请 求 。 RequestHandler 类 就 是 为 处 理 这 些 请 求 而 创建 的 一 一 这 是 开发 者 

使 用 最 多 的 webapp 类 。 

@ 在 欢迎 应 用 程序 中 ， 我 们 唯一 需要 处 理 的 HTTP 请 求 是 GET。 在 webapp 中 ， 开 发 者 提供 
RequestHandler 子 类 的 get (函数 的 实现 就 可 以 处 理 该 请 求 。 

@ webapp 并 不 手工 生成 MIME 头 等 内 容 ， 而 是 给 开发 者 提供 一 个 包含 Python 映射 的 响应 结 
构 。 开 发 者 要 想 给 任何 HITP 头 设置 值 ， 在 映射 中 赋值 即 可 。 我 们 用 到 的 唯一 的 头 是 
Content-Type， 所 以 将 它 写 人 映射 中 。 

© webapp 并 不 将 生成 的 结果 直接 输出 到 标准 输出 ， 而 是 给 开发 者 提供 了 一 个 可 管理 的 缓存 
输出 通道 。 开 发 者 将 响应 的 内 容 写 到 缓存 输出 通道 。App Engine 开 发 者 新 手 最 常 犯 的 错 
误 是 : 他 们 用 以 往 的 旧式 输出 语句 输出 HTML， 然 后 质疑 为 什么 看 不 到 输出 结果 。 开 发 
者 需要 确保 自己 始终 在 使 用 webapp 的 缓存 输出 通道 。 

@ 为 了 使 用 webapp 的 RequestHandler, 我 们 需要 创建 一 个 应 用 程序 对 象 。 应 用 程序 对 象 与 
app.yam1 文 件 非 常 相似 :app .yam1 文 件 描述 的 是 如 何 将 收 到 的 请 求 映射 到 特定 的 应 用 程 
序 脚本 上 ， 而 应 用 程序 对 象 描述 的 是 如 何 获取 映射 到 该 脚本 的 请 求 ， 并 将 这 些 请 求 映 射 
到 特定 的 RequestHandler 类 上 ,我 们 将 对 根 URL 的 请 求 , 即 对 http:/markcc-chatroom-one/ 
的 请 求 ， 映 射 到 欢迎 页 面 请 求 处 理 程序 上 。 

@ 文件 的 其 余部 分 使 用 了 一 个 常见 的 Google 用 法 。 为 了 实际 运行 应 用 程序 ， 该 脚本 需要 调 
用 。 但 是 ,我 们 并 不 是 直接 执行 该 语句 ， 而 是 编写 一 个 主 函 数 ， 使 用 间接 方式 调用 它 。 
这 个 用 法 使 得 脚本 的 复 用 变 得 容易 。 如 果 我 们 直接 运行 run_wsgi_app, 那么 当 需 要 在 其 
他 Python 代码 中 引入 该 脚本 时 ， 就 会 执行 该 行 。 增 加 了 条 件 调用 的 主 函 数 保证 了 该 脚本 
只 有 在 专门 调用 时 才 会 被 执行 ， 而 不 会 被 引入 它 的 模块 执行 。 

我 们 可 以 使 用 与 上 一 个 程序 相同 的 方式 部 署 这 一 新 版 本 。 我 修改 了 Python 脚本 的 文件 名 ， 所 

以 还 需要 更 新 app.yam] 文 件 ， 以 引用 新 的 Python 脚本 文件 。 一 旦 完成 这 些 操作 ， 只 需 运 行 

appcfg.py update chatone 就 可 以 完成 部 署 。 该 命令 会 上 传 更 新 。 更 新 一 旦 执行 完成 ， 就 会 访 

问 应 用 程序 的 URL， 随 即 运 行 新 版 本 代码 。 在 Google App Engine 中 ， 它 仍然 会 显示 为 版 本 1 ， 

为 我 并 没有 修改 app.yam1 中 的 版 本 标识 符 。 
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这 样 粗 略 的 讲解 ， 只 是 告诉 开发 者 什么 是 Google App Engine 程 序 开发 。 在 后 续 的 章节 中 ， 我 
们 将 更 加 详细 地 讲解 如 何 使 用 App Engine 开 发 有 趣 的 网 络 应 用 程序 。 


2.4 监视 应 用 程序 


作为 应 用 程序 开发 人 员 ， 你 会 想 去 监视 该 应 用 程序 ,以 便 能 够 监测 有 多 少 用户 、 耗 费 多 少 资 
源 、 点 击 数 有 多 少 、 哪 些 脚本 使 用 最 活跃 、 什 么 脚本 在 工作 、 什 么 脚本 没有 工作 等 等 。 开 发 者 可 
以 使 用 Google App Engine 控 制 面板 实现 这 些 。 

Google App Engine 控 制 面板 的 监视 功能 对 开发 者 确实 很 重要 。 由 于 云 应 用 程序 运行 在 不 受 开 
发 者 控制 的 计算 机 上 , 开发 者 不 可 能 只 运行 分 析 器 或 者 调试 器 就 能 分 析出 为 什么 应 用 程序 没有 按 
照 预期 的 方式 工作 , 所 以 当 开 发 者 发 现 有 些 部 分 运行 的 时 间 比 预期 的 时 间 长 很 多 时 ( 只 要 编写 的 
是 正常 的 应 用 ， 这 样 的 事情 总 会 发 生 )， 监 视 器 是 开发 者 的 信息 来 源 。 

例如 ,在 日 常 工作 中 ， 我 会 为 Google 构 建 基于 云 的 数据 分 析 应 用 程序 。 我 不 止 一 次 地 遇 到 
这 样 的 情况 , 通常 运行 1 个 小 时 的 分 析 程 序 居 然 耗 费 了 8 个 小 时 ,情况 明显 非常 糟糕 。 通 过 控制 面 
板 我 就 能 知道 发 生 了 什么 ,我 查看 控制 面板 提供 的 信息 ， 发 现 系统 处 理 的 某 些 数据 碎片 非常 大 ， 
远 远 超出 正常 水 平 。 这 使 我 顺藤摸瓜 找到 了 问题 所 在 : 有 人 修改 了 分 析 器 输入 数据 的 代码 ， 而 其 
生成 的 数据 的 形式 影响 了 我 代码 的 性 能 。 如 果 没 有 工具 让 我 查看 服务 需 集 群 上 发 生 了 什么 的 话 ， 
想 找 出 这 个 原因 将 异常 困难 。 

开发 者 可 以 监视 应 用 程序 的 方方面面 一 一 从 程序 运行 过 程 中 代码 记录 的 信息 , 到 Google App 
Engine 服 务 器 记录 的 信息 ， 再 到 应 用 程序 消耗 的 资源 的 详细 信息 ， 都 在 控制 面板 中 。 

应 用 程序 控制 面板 的 主 视 图 称 为 仪表 板 。 仪 表 板 提供 了 开发 者 想 知 道 的 有 关 应 用 程序 的 状态 
和 资源 使 用 情况 的 一 切 内 容 的 摘要 , 并 包含 可 以 得 到 更 多 详细 信息 的 链接 。 仪 表 板 分 为 四 个 部 分 ， 
如 图 2-3 所 示 。 

























































































口 应 用 程序 性 能 的 可 视 化 视图 ， 这 部 分 可 以 用 来 显示 应 用 程序 随 着 时 间 的 变化 使 用 资源 的 

口 账单 状态 视图 ， 显 示 开 发 者 对 每 类 资源 已 经 使 用 了 多 少 ， 以 及 在 账单 计划 内 还 有 多 少 可 
用 。 

口 负载 视图 ， 显 示 app.yam] 文 件 中 声明 的 不 同 的 URI 模 式 ， 以 及 响应 每 类 请 求 分 别 耗 费 了 
多 少 CPU 时 间 。 

口 错误 视图 ， 显 示 应 用 程序 中 出 现 的 全 部 错误 的 基本 摘要 信息 。 


最 后 ， 控 制 面板 提供 了 一 组 有 用 的 链接 ， 列 在 “资源 ”( Resources ) 下 边 。 这 些 资源 包括 : 
开发 者 论坛 ， 在 此 开发 者 可 以 与 Google App Engine 的 其 他 开发 者 以 及 Google 的 App Engine 团 队 讨 
论 问题 ; 官方 最 新 的 App Engine 文 档 ; 常见 问题 的 解答 。 我 强烈 建议 开发 者 使 用 这 些 链接 ， 特 别 
是 开发 者 论坛 。 开 发 者 开发 App Engine 程 序 遇 到 的 大 多 数 问题 ， 与 其 他 App Engine 开 发 人 员 遇 到 
的 问题 类 似 ， 论 坛 里 会 有 你 需要 的 答案 。 
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图 2-3 ”控制 面板 的 各 部 分 


除了 这 些 基本 的 资源 信息 , 在 控制 面板 主 视图 的 左边 有 一 组 管理 链接 , 开发 者 可 以 进一步 详 
细 查 看 系统 的 各 个 方面 。 

该 详细 链接 提供 有 用 数据 的 一 个 例子 就 是 应 用 程序 的 日 志 信息 。 Google App Engine 服 务 顺 收 
到 每 个 请 求 都 会 生成 一 个 描述 该 请 求 的 数据 记录 。 此 外 ,错误 也 记录 在 日 志 里 。 当 开发 者 的 应 用 
程序 抛 出 异常 时 ， 异常 不 会 显示 给 用 户 , 唯一 可 以 看 到 异常 的 地 方 是 在 日 志 里 。 男 外 ， 开 发 者 也 
可 以 在 程序 中 添加 日 志 记 录 语 句 。 下 面 ， 我 们 就 来 看 看 请 求 日 志 。 

打开 应 用 程序 的 控制 面板 。 屏 幕 左 侧 包含 了 各 种 视图 的 链接 ， 以 及 用 于 监视 、 控 制 和 管理 应 
用 程序 的 工具 集合 。 最 上 面 的 部 分 是 “ 主 标签 "， 第 三 个 链接 是 “日 志 ”。 点 击 “ 日 志 ” 链 接 ， 切 
换 到 显示 日 志 信 息 的 视图 。 到 这 一 步 ， 如 果 开 发 者 没有 犯 任何 错误 , 视图 的 内 容 基 本 上 为 空 
日 志 的 默认 视图 是 应 用 程序 遇 到 过 的 所 有 错误 的 简洁 视图 。 
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图 2-4 请求 日 志 视 图 
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要 查看 应 用 程序 已 经 处 理 的 请 求 , 需要 使 用 在 日 志 列 表 上 方 标 有 “最 小 严重 性 ”的 下 拉 框 菜 
单 。 打 开 该 菜单 ， 并 选择 “ 仅 请 求 ”， 结 果 如 图 2-4 所 示 ， 显 示 的 是 应 用 程序 收 到 的 每 一 个 请 求 的 
日 志 表 项 列表 。 

至 此 就 完成 了 所 有 设置 。 开 发 者 拥有 了 自己 的 Google App Engine 账 户 ， 并 安装 了 App Engine 
工具 。 已 经 可 以 建立 App Engine 应 用 程序 了 。 在 下 一 章 中 ， 我 们 将 使 用 刚刚 安装 的 App Engine 工 
具 构 建 一 个 真正 运行 在 云 中 的 聊天 应 用 。 





2.5 ”参考 文献 和 资源 


口 Google App Engine 开 发 者 指南 ，http://code.google.com/appengine/docs/。 
针对 Python 和 Java API 的 官方 Google App Engine 文 档 。 

口 通用 网 关 接 口 (CGI) ，http:/www.w3.org/CGIL/。 

CGI 的 官方 标准 和 文档 。 
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在 这 一 章 中 , 我们 将 建立 第 一 个 有 实际 意义 的 云 应 用 程序 : 一 个 基本 的 Python 聊天 室 。 通 过 
这 个 过 程 ， 我 们 将 了 解 如 下 内 容 。 
口 云 应 用 程序 使 用 的 HTTP 协 议 ， 以 及 云 应 用 程序 如 何 通信 。 
口 如 何 将 一 个 用 Python 编写 的 普通 非 云 程序 用 HTTP 框 架 封 装 ， 使 其 可 以 在 云 中 工作 。 
口 在 云 应 用 程序 中 ， 如 何 管理 数据 和 变量 。 


3.1 基本 的 聊天 应 用 程序 


作为 一 个 运行 实例 , 我 们 将 用 Python 构建 一 个 聊天 服务 。 这 是 一 个 很 好 的 例子 ,因为 大 家 都 熟悉 
它 一 一 我 们 都 使 用 过 聊天 服务 。 但 即使 是 这 一 古老 常见 的 应 用 程序 ， 它 也 有 许多 云 服务 的 典型 特点 。 

云 应 用 与 众 不 同 、 引 人 入 胜 的 原因 在 于 : 它 本 质 上 是 多 用 户 的 。 开 发 者 构建 云 应 用 程序 ， 必 
须要 考虑 如 何 应 对 多 用 户 ， 以 及 如 何 处 理 多 用 户 数据 。 

聊天 应 用 程序 虽然 简单 ,但 却 非常 典型 。 要 构建 一 个 聊天 程序 , 我 们 需要 考虑 多 用 户 之 间 的 
交互 , 需要 存储 和 读 取 永久 型 数据 ,并且 针对 不 同 的 讨论 话题 会 有 多 个 数据 流 。 考 虑 好 这 些 ， 就 
可 以 很 容易 地 创建 一 个 简单 的 版 本 ， 然 后 逐步 增加 新 的 功能 ， 展 示 越 来 越 多 的 App Engine 功 能 。 

在 这 一 部 分 ， 我们 将 忽略 用 户 界面 ， 将 注意 力 集中 在 后 台 ( 我 们 将 在 第 7 童 讲述 用 户 界面 相 
关内 容 )。 而 现在 ,我 们 只 编写 一 个 传统 的 本 地 聊天 应 用 程序 的 基本 后 台 ， 通 过 函数 调用 将 其 与 
用 户 界面 挂 接 。 在 本 章 我 们 不 实现 整个 聊天 应 用 程序 , 但 本 书 的 主要 内 容 就 是 逐步 完成 聊天 应 用 
软件 的 所 有 工作 。 

一 个 基本 的 聊天 应 用 程序 并 不 是 很 复杂 。 可 以 想象 一 下 那 种 典型 的 聊天 程序 。 聊 天 程序 的 用 
户 界面 非常 简单 ， 它 应 该 有 两 个 窗口 ,一 个 可 以 看 到 聊天 内 容 , 一 个 用 于 输入 新 的 文本 。 聊 天 内 
容 应 包含 聊天 过 程 中 发 送 的 一 系列 消息 ， 每 条 消息 用 发 送 者 的 名 称 和 消息 发 送 的 时 间作 为 标识 。 
那么 ， 基 本 的 聊天 界面 看 起 来 应 该 与 图 3-1 的 模型 类 似 。 

现在 我 们 大 概 知道 聊天 程序 应 该 是 什么 样子 , 可 以 开始 考虑 如 何 去 构 建 它 了 。 在 开始 剖析 如 
何 构建 一 个 云 应 用 程序 前 , 我 们 首先 考虑 如 何 实现 一 个 聊天 应 用 程序 的 后 台 作为 标准 的 服务 器 程 
序 。 因 此 ， 我 们 将 致力 于 开发 应 用 程序 架构 ， 该 架构 不 使 用 任何 App Engine 代 码 ， 而 是 使 用 标准 
Python 完成 聊天 程序 所 需 的 所 有 功能 。 





































































































3.1 基本 的 聊天 应 用 程序 23 





i 『 
MarkCC (10:46): Hello, is there anybody there? Transcript Area 1 
Prag (10:47): Yup, lm here 
Prag (10:47): So how's the book coming? 
User Jim has entered 


MarkCC (10:48): its coming along well Im writing about the chat application 





图 3-1 ”聊天 界面 的 模型 


我 们 需要 实现 什么 呢 ?” 从 基本 的 聊天 内 容 我 们 可 以 看 到 ， 聊 天 系统 有 一 个 虚拟 空间 ,用户 
可 以 进入 和 离开 该 虚拟 空间 。 用 户 进 入 后 ， 可 以 发 送 消息 。 任 何 已 发 送 的 消息 对 所 有 已 经 进入 
该 空间 的 人 都 是 可 见 的 。 因 此 ， 我 们 要 处 理 三 个 基本 对 象 : 空间 (我 们 称 为 聊天 室 )、 用 户 和 

我 们 希望 该 空间 里 能 够 进行 多 个 会 话 , 从 而 可 使 用 户 决定 他 们 想 要 谈论 的 内 容 , 以 及 谈话 对 
象 。 我 们 称 能 够 发 生 一 个 会 话 的 空间 为 聊天 室 。 聊 天 室 里 可 能 发 生 3 件 相关 的 事件 : 用 户 可 以 进 
入 、 可 以 离开 、 可 以 发 送 消 息 。 此 外 ,为 了 简化 ,我 们 并 不 在 每 条 消息 发 送出 去 后 就 自动 更 新 每 
个 人 的 聊天 内 容 , 而 仅仅 提供 给 用 户 定期 查看 聊天 内 容 的 方式 .下 面 是 一 个 简单 的 聊天 室 的 实现 。 
该 实现 不 是 按照 云 开发 的 方式 编写 的 。 云 应 用 程序 的 行为 与 此 完全 不 同 , 所 以 云 编程 需要 有 不 同 
的 实现 。 在 本 书 的 后 续 部 分 ， 我 们 会 构建 一 个 App Engine 的 云 应 用 程序 ， 它 会 使 用 云 中 的 方式 完 
成 本 程序 的 所 有 工作 。 到 时 ， 读 者 可 以 看 到 它们 之 间 有 多 大 的 差别 。 
































basechat.py 


class ChatRoom(object): 
mmm chatroom™"" 


rooms = {} 


def __init__ (self, name): 
self.name = name 
self.users = [] 
self.messages = [] 
ChatRoom.rooms[name] = self 


def addSubscriber(self, subscriber): 
self.users.append(subscriber) 
subscriber.sendMessage(self.name, "User %s has entered." % subscriber.username) 


def removeSubscriber(self, subscriber): 
if subscriber in self.users: 
subscriber.sendMessage(self.name, "User %s is leaving." % subscriber.username) 
self.users.remove(subscriber) 


def addMessage(self, msg): 
self.messages.append(msg) 
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def printMessages(self, out): 
print >>out, "Chat Transcript for: %s" % self.name 
for i in self.messages: 
print >>out, i 


聊天 室 需 要 的 下 一 个 元 素 是 用 户 。 用 户 有 一 个 名 称 , 并 注册 了 一 些 聊 天 室 。 用 户 可 以 进入 聊 
天 室 、 离 开 聊 天 室 , 或 发 送 消 息 。 如 果 他 们 还 没有 进入 某 个 特定 的 聊天 室 ， 则 不 允许 向 那个 聊天 
室 发 送 消息 。 




















basechat.py 


class ChatUser(object): 
"""A user participating in chats 
Def __init__ (self, username): 
self.username = username 
self.rooms = {} 


def subscribe(self, roomname): 
if roomname in ChatRoom.rooms: 
room = ChatRoom.rooms[roomname] 
self.rooms[roomname] = room 
room.addSubscriber(self) 
else: 
raise ChatError("No such room %s 


% roomname) 


def sendMessage(self, roomname, text): 

if roomname in self.rooms: 
room = self.rooms[roomname] 
cm = ChatMessage(self, text) 
room.addMessage(cm) 

else: 
raise ChatError("User %s not subscribed to chat %s" % 

(self.username, roomname)) 


def displayChat(self, roomname, out): 
if roomname in self.rooms: 
room = self.rooms[roomname] 
room.printMessages (out) 
else: 
raise ChatError("User %s not subscribed to chat %s" % 
(self.username, roomname)) 


聊天 消息 是 最 简单 的 部 分 , 它 只 是 来 自用 户 的 消息 。 消息 需要 包括 发 送 消 息 的 用 户 、 用 户 想 
要 发 送 的 文本 ， 以 及 消息 发 送 的 时 间 。 








basechat.py 


class ChatMessage(object): 
"""A single message sent by a user to a chatroom. 
def __init__ (self, user, text): 
self.sender = user 
self.msg = text 
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self.time = datetime.datetime.now() 
def __str__ (self): 
return "From: %s at %s: %s" % (self.sender.username, self.time, self.msg) 


为 了 测试 聊天 消息 对 象 , 我 们 仅 编 写 一 个 简捷 的 主 程序 一 一 也 就 是 说 , 我 们 编写 的 代码 具有 
聊天 应 用 程序 所 需 的 功能 。 在 该 示例 中 , 我 们 只 是 演示 程序 实际 运行 时 可 能 是 什么 样子 ， 而 不 是 
进行 真正 的 交互 式 聊天 。 我 们 用 该 程序 创建 一 些 用 户 ， 让 用 户 订阅 一 些 聊 天 室 ， 并 发 送 消息 。 



























































basechat.py 


def main(0) : 
room = ChatRoom("Main") 
markcc = ChatUser("MarkCC") 
markcc.subscribe("Main") 
prag = ChatUser("Prag") 
prag.subscribe("Main") 


markcc.sendMessage("Main", "Hello! Is there anybody out there?") 
prag.sendMessage("Main", "Yes, I'm here.") 
markcc.displayChat("Main", sys.stdout) 


if name__== "__main 
main() 


当 我 们 运行 该 程序 时 ， 得 到 如 下 信息 : 


Chat Transcript for: Main 

From: MarkCC at 2009-06-27 15:10:51.181035: User MarkCC has entered. 

From: Prag at 2009-06-27 15:10:51.181194: User Prag has entered. 

From: MarkCC at 2009-06-27 15:10:51.181218: Hello! Is there anybody out there? 
From: Prag at 2009-06-27 15:10:51.181237: Yes, I'm here. 


它 远 不 够 完美 。 时 间 标 签 过 于 详细 ， 而 且 文 本 没有 格式 化 , 不 易 阅 读 , 但 是 基本 的 聊天 功能 
( 聊天 室 、 订 阅 、 用 户 和 消息 ) 都 有 了 。 

















3.2 HTTP 基础 


刚才 设计 并 实现 聊天 室 的 架构 ,对 传统 应 用 程序 来 说 是 一 种 合理 的 开发 方式 。 但 是 若 要 设计 
一 个 在 云 中 运行 的 应 用 程序 ， 则 还 需要 男 一 个 步 又 。 在 传统 的 应 用 程序 中 ,开发 者 要 思考 如 何 设 
计 应 用 程序 的 后 台数 据 处 理 , 而 且 必 须 设计 用 户 界 面 。 编写 云 应 用 程序 时 , 仍然 需要 做 这 些 事情 ， 
同时 ， 还 需要 设计 应 用 程序 的 协议 。 

云 应 用 的 后 台 运 行 在 数据 中 心 某 处 的 一 台 服 务 器 或 一 组 服务 器 上 , 而 用 户 界面 运行 在 用 户 的 
网 络 浏览 器 中 。 协议 的 工作 就 是 描述 后 台 和 前 台 如 何 通 信 , 从 而 生成 一 个 看 起 来 好 像 是 在 用 户 的 
浏览 器 里 运行 的 应 用 程序 。 

大 多 数 云 应 用 程序 ， 以 及 几乎 所 有 的 App Engine 应 用 程序 ， 都 是 基于 一 种 称 为 HTTP ( 超 文 
本 传输 协议 ) 的 基本 协议 构建 的 。 对 云 应 用 程序 而 言 ， 开 发 者 需要 设计 一 种 置 于 HTTP 上 层 的 协 
议 。 这 里 的 分 层 只 是 意味 着 : 该 协议 构建 的 目的 是 使 应 用 程序 协议 中 的 每 个 交互 都 是 用 HTTP 交 
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互 进行 描述 的 。 这 是 云 应 用 程序 开发 与 传统 的 应 用 程序 开发 不 同 的 关键 因素 之 一 , 云 应 用 程序 紧 

密 玮 绕 客户 端 和 服务 器 的 HTTP 交互 建立 , 将 应 用 程序 正确 地 县 加 在 HTTP 之 上 是 构建 吸引 人 的 云 

应 用 的 关键 ， 这 样 才 能 够 提供 良好 的 用 户 体 验 。 如 果 开 发 者 不 习惯 HTTP 的 话 ， 可 能 就 会 觉得 它 

有 点 麻烦 ， 但 稍 后 在 本 书 中 ， 读 者 将 会 看 到 如 何 使 用 HTTP 交 互 来 构建 几乎 任意 类 型 的 应 用 。 

也 许 读者 已 经 熟悉 HTTP 了 , 但 仍 值得 花 时 间 来 回顾 一 下 , 因为 了 解 HTTP 的 基本 知识 对 理解 

App Engine 应 用 程序 的 工作 原理 非常 重要 。 下 面 ， 在 学 习 如 何 为 聊天 室 组 建 应 用 程序 协议 前 ， 我 

们 先 回顾 一 下 HTTP 的 基本 知识 。 

HTTP 是 一 种 简单 的 请 求 / 响 应 式 的 客户 端 - 服 务 器 端 协议 。 换 名 话说 ， 它 是 一 个 支持 双方 通信 

的 协议 。 其 中 一 方 称 为 客户 端 ， 另 一 方 称 为 服务 器 端 。 客 户 端 和 服务 器 端 有 不 同 的 行为 。 在 HTTP 

中 ， 客 户 端 向 服务 器 端 发 送 请 求 ， 是 真正 的 通信 发 起 方 ; 服务 器 端 处 理 来 自 客 户 端的 请 求 ， 并 发 

送 响 应 。HTTP 做 的 几乎 所 有 工作 就 是 ， 描 述 客 户 端 向 服务 器 端 发 送 请 求 以 及 得 到 响应 的 方式 。 

为 了 使 事情 更 加 简化 ， 每 一 个 HTTP 请 求 都 汇聚 在 一 个 资源 上 。 资 源 是 网 络 中 赋予 了 名 称 的 

任意 事物 。 资 源 还 有 一 个 名 称 是 统一 资源 定位 符 ， 即 URL。URL 是 一 种 文件 名 ,不 同 的 是 它 可 以 

被 用 来 命名 很 多 不 同 的 东西 : 文件 、 程 序 、 人 、 过 程 或 者 你 能 够 想象 到 的 几乎 任何 事物 。 每 一 个 

HTTP 请 求 或 者 要 求 从 资源 中 回收 数据 ， 或 者 向 资源 发 送 数据 。 

每 个 来 自 客户 端的 HTTP 请 求 调用 服务 器 上 的 方法 。( 不 要 被 这 些 术语 迷惑 : 虽然 称 之 为 “ 方 

法 ”, 但 HTTP 实 际 上 并 没有 面向 对 象 的 内 容 。 ) HTTP 有 以 下 四 个 基本 方法 (另外 还 有 大 约 数 十 个 

扩展 ， 因 为 网 络 应 用 程序 不 需要 这 些 扩 展 ， 所 以 我 们 先 不 描述 它们 )。 

口 GET 要 求 服 务 器 从 资源 获取 一 些 信息 ， 并 且 将 其 发 送 给 客户 端 。 

口 HEAD ”要 求 服 务 器 告诉 客户 端 有 关 资 源 的 信息 。 基 本 上 和 GET 请 求 类 似 ， 不 同 的 是 应 答 
只 包含 元 数据 。 开 发 者 可 以 使 用 该 请 求 完成 如 查询 “资源 有 多 大 ? ”等 类 似 工作 ， 而 不 
需要 下 载 整个 资源 。 通 常 ， 大 多 数 网 络 应 用 程序 不 使 用 HEAD 方 法 ,但 是 它 有 时 非常 有 用 。 

口 PUT 把 数据 存储 到 资源 里 。 客 户 端 将 信息 发 送 到 服务 器 端 ， 将 信息 存储 到 目标 资源 里 ， 

服务 器 端 应 答 只 需要 说 明 数据 是 否 正确 存储 即 可 。 

口 POST “将 数据 发 送 给 服务 器 端 上 的 程序 。POST 请 求 有 点 奇怪 。PUT 和 POST 并 没有 太 大 不 
同 。 两 者 的 区 别 要 追溯 到 万 维 网 早期 ， 即 人 们 在 自己 独立 的 计算 机 上 运行 网 络 服务 器 的 
时 期 。 在 早期 网 络 服务 器 的 实现 中 ， 所 有 的 GET 和 PUT 请 求解 析 为 取 回 和 存放 文件 。 所 以 
为 了 能 够 在 网 络 服务 器 上 运行 程序 ， 开 发 者 需要 一 个 不 同 的 HTTP 协 议 请 求 ， 该 请 求 专用 
于 要 求 开 发 者 运行 程序 。 在 现代 系统 中 ，PUT 和 POST 几乎 是 通用 的 。 

开发 者 使 用 网 络 浏 览 器 生成 的 每 个 HTML 请 求 ， 以 及 App Engine 服 务 要 处 理 的 每 个 HTML 请 

求 有 以 下 3 个 部 分 。 

口 请 求 行 : 包括 该 请 求 的 HTTP 方 法 ， 后 接 资 源 的 URL 地 址 ， 最 后 是 协议 版 本 声明 。 浏 览 器 

生成 大 多 数 请 求 使 用 的 方法 是 GET， 并 且 版 本 声明 通常 是 HTTP/1.1。 

口 一 系列 头 部 行 : 由 有 关 请 求 的 元 数据 组 成 ( 如 我 们 在 2.3 节 “开始 App Engine 中 的 Python 

编程 ”中 ， 欢 迎 应 用 程序 使 用 的 Content-Type 声 明 )。 来 自 浏 览 带 的 多 数 请 求 都 会 有 头 

部 行 , 告诉 服务 器 , 用 户 使 用 什么 浏览 器 ( User-Agent 头 部 ) 以 及 一 些 用 户 标 识 符 ( From: 
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头 部 )。 头 部 也 可 以 包含 cookie 索 引 、 语 言 标识 符 、 网 址 等 。 实 际 上 ， 任 何 内 容 都 可 以 放 
在 头 部 ， 因 为 服务 融会 包 略 其 不 识别 的 头 部 。 
口 主体 : 包含 任意 的 数据 流 。 
头 部 的 结束 和 主体 的 开始 通过 空 行 分 隔 。 通 常 ，GET 请 求 和 HEAD 请 求 的 消息 主体 是 空 的 。 例 
如 ， 下 面 是 一 个 简单 的 GET 请 求 : 


GET /rooms/chatter HTTP/1.1 


User-Agent: Mozilla/5.001 (windows; U; NT4.0; en-US; rv:1.0) Gecko/25250101 
Host: markcc-chatroom-one.appspot.com 


当 开发 者 给 服务 器 发 送 HTML 请 求 时 ,服务 器 应 答 一 个 类 似 结构 的 消息 。 不 同 之 处 在 于 在 请 
求 行 的 地 方 ， 服务 器 以 状态 行 开始 响应 消息 。 状 态 行 的 开头 是 状态 码 和 状态 消息 ,告诉 开发 者 请 
求 是 否 已 被 正确 处 理 ， 如 果 没 有 ， 是 什么 地 方 出 错 了 。 开 发 者 的 云 服 务 需要 人 处理 的 典型 状态 行 与 
HTTP/1.1 200 Ok 类似 , 其 中 HTTP/1.1 告 诉 开发 者 服务 器 使 用 的 协议 版 本 , 200 是 响应 的 状态 码 ， 
OK 是 状态 文本 。 

状态 码 总 是 由 3 个 数字 组 成 。 第 一 个 数字 是 常见 的 响应 类 型 。 

1 表示 “信息 响应 ”。 

2 表示 成 功 。 

3 表示 重 定向 ,告诉 客户 端 到 别 的 位 置 去 查找 资源 。( 实际 上 ， 重 定向 是 发 给 客户 端的 消 
息 ， 表 示 “ 如 果 你 想 要 该 资源 ， 在 这 个 URL 上 查找 它 ”。 ) 

4 表示 客户 端 错误 (例如 ，404 的 意思 是 客户 端 请 求 的 资源 在 该 服务 器 上 并 不 存在 )。 

5 表示 服务 器 错误 ( 例如， 该 请 求 引发 服务 器 执行 一 个 脚本 ， 而 这 个 脚本 崩 演 了 )。 

例如 ， 下 面 是 一 个 对 上 述 GET 请 求 的 成 功 应 答 : 


HTTP/1.1 200 OK 
Date: Sat, 26 Jun 2009 21:41:13 GMT 
Content-Type: text/html Content-Length: 123 


















































<htm1> 
<body> 
<p> MarkCC: Hello, is there anybody out there?</p> 
<p> Prag: Yes, I'm here.</p> 
</body> 
</htm1> 





让 我 们 试 着 贯穿 一 个 完整 的 请 求 /响应 循环 。 假 设 我 们 的 应 用 程序 使 用 POST 提交 聊天 消息 。 
请 求 可 能 看 起 来 如 下 所 示 : 


POST /submit HTTP/1.1 

User-Agent: Mozilla/5.001 (windows; U; NT4.0; en-US; rv:1.0) Gecko/25250101 
Host: markcc-chatroom-one.appspot.com 

From: markccQ@phouka.1local 


<ChatMessage> 
<User>MarkCC</User> 
<Date>June 26, 2009 16:33:12 EDT</Date> 
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<Body>Hello, is there anybody out there?</Body> 
</ChatMessage> 


HTTP 状态 码 

HTTP 标 准 具 有 大 量 的 服务 器 结果 状态 码 。 以 下 这 些 是 开发 者 最 常 遇 到 的 状态 码 。 

口 200 成 功 请求 已 被 成 功 完 成 。 消 息 的 主体 将 包含 成 功 请 求 的 结果 。 

口 301 永 久 移动 ”请 求 已 被 永久 移 除 ， 并 且 该 请 求 以 及 对 该 资源 以 后 的 所 有 请 求 都 应 
该 发 送 到 新 的 地 址 。 

口 303 查 看 其 他 ”对 于 该 请 求 ， 可 以 通过 对 其 他 URL 进 行 GET 操 作 得 到 结果 。URL 可 
以 在 消息 头 部 的 位 置 找 到 。 这 通常 用 作 PUT 请 求 的 结果 ， 当 PUT 处 理 成 功 后 ， 服 务 
器 告诉 客户 端 在 哪里 查看 操作 结果 。 

口 401 未 经 授权 ”请求 是 有 效 的 ， 但 是 用 户 没 有 提供 任何 身份 认证 数据 ， 表 明 自 己 应 
该 被 允许 看 到 该 资源 。 用 户 可 以 使 用 某 些 其 他 请 求 ， 先 获得 一 个 认证 码 ， 然 后 重 试 
该 请 求 。 

口 403 禁 止 ”请求 是 有 效 的 ， 但 是 用 户 不 被 允许 访问 指定 的 资源 。 这 与 401 相 类 似 ， 但 
表示 用 户 已 经 通过 身份 认证 ， 仍 然 无 法 访问 该 资源 ， 甚 至 不 被 允许 访问 此 资源 。 

口 404 未 找到 ”在 指定 的 位 置 没 有 找到 该 资源 。 

口 500 内 部 服务 器 错误 ”服务 器 在 处 理 请 求 过 程 中 发 生 的 任何 错误 最 终 都 将 产生 一 个 
500 错 误 。 对 于 开发 者 实现 的 App Engine 服 务 ， 当 开发 者 的 请 求 处 理 程序 前 渍 或 产生 
异常 时 ， 客 户 端 浏览 器 会 收 到 一 个 500 状 态 码 。 

口 501 未 实现 ”该 请 求 希 望 执行 某 个 操作 ， 但 是 服务 器 不 支持 该 操作 。 通 常 ， 如 果 开 
发 者 在 POST 请 求 中 拼 错 URL 地 址 ， 则 会 出 现 这 种 错误 。 








如 果 消 息 发 送 成 功 ， 应 答 可 能 类 似 如 下 内 容 : 


HTTP/1.1 303 See other 
Date: Sat，26 Jun 2009 21:41:13 GMT 
Location: http://markcc-chatroom-one.appspot.com/ 


3.3 ”聊天 应 用 程序 到 HTTP 的 映射 


为 了 使 我 们 的 Python 聊天 应 用 程序 作为 App Engine 的 网 络 应 用 程序 工作 ， 需 要 将 该 应 用 程序 
的 基本 操作 映射 到 HTTP 的 请 求 和 响应 上 。 

在 这 个 版 本 中 , 我们 先 不 处 理 订阅 : 因为 只 有 一 个 聊天 室 ， 所 以 如 果 用 户 连 接 到 该 聊天 应 用 
程序 ， 他 就 已 经 在 聊天 室 里 了 。 而 且 现 在 我 们 也 不 必 考 虑 用 户 的 进入 和 离开 。 

假如 你 在 使 用 聊天 室 ， 那 么 你 希望 能 够 做 哪些 事情 呢 ? 
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首先 ， 你 要 在 聊天 室 里 看 到 所 有 的 新 消息 。 拿 HTTP 术 语 来 说 就 是 : 聊天 室 是 一 个 资源 ， 你 
想 看 到 它 的 内 容 。 这 自然 适合 使 用 GET: 你 希望 浏览 器 能 够 取 回 聊天 室 的 内 容 ， 然 后 显示 给 你 。 

你 还 希望 能 够 发 送 消息 , 所 以 这 就 需要 浏览 器 能 够 作为 一 个 活动 的 实体 与 聊天 室 交 谈 , 并 告 
诉 聊天 室 应 用 程序 你 有 话 要 说 。 再 者 ， 聊 天 室 是 资源 ， 但 是 这 次 你 想 要 和 它 交 谈 。 这 是 一 个 PUT 
或 POST 操作 。 在 决定 要 使 用 PUT 还 是 POST 时 ， 可 以 问 问 自 己 ， 你 究竟 是 想 要 替换 资源 的 内 容 ,还 
是 想 与 资源 进行 交互 ? 向 聊天 室 发 布 一 条 消息 显然 属于 后 者 , 我 们 不 想 替 换 聊 天 室 的 内 容 ， 而 是 
要 与 它 交 谈 , 并 且 告 诉 它 有 一 条 新 消息 要 添加 到 会 话 中 。 因 此 , 发 送 一 个 新 消息 绝对 是 一 个 POST 
操作 。 

这 样 ， 我 们 得 到 了 应 用 程序 所 需 的 框架 。 我 们 要 有 一 个 资源 ， 即 一 个 聊天 室 。 用 户 可 以 GET 性 一 
该 资源 ,查看 当前 的 聊天 状态 。 我 们 还 需要 另外 一 种 资源 ， 它 是 个 活动 的 进程 ,用 户 向 聊天 室 发 
送 新 消息 并 被 添加 到 聊天 内 容 中 时 ， 可 以 POST 给 该 进程 。 

现在 ， 我 们 需要 思考 一 点 有 关 用 户 界面 的 问题 。 用 户 如 何 能 够 向 我 们 的 应 用 程序 POST 数据 
呢 ?” 这 需要 一 个 方法 来 实现 。 最 简单 的 方法 是 当 用 户 要 求 查 看 聊天 室 时 , 在 其 发 送 的 页 面 里 创建 
一 个 表单 。 这样 , 聊天 页 面 项 部 会 有 一 个 标题 , 然后 , 页 面 会 有 一 个 聊天 室内 容 的 副本 , 再 然后 ， 
在 页 面 底部 ， 要 有 一 个 输入 框 来 接收 用 户 名 称 和 用 户 想 要 发 布 的 消息 。 

为 了 用 App Engine 实 现 此 应 用 程序 ， 我们 需要 建立 一 个 RequestHandler， 用 来 实现 聊天 
室内 容 的 GET 操 作 ， 然 后 建立 另外 一 个 RedquestHandler， 用 来 接收 POST 操作 ， 并 向 聊天 室 添 
加 内 容 。 

聊天 室 的 主页 与 我 们 在 第 2 章 所 使 用 的 代码 几乎 相同 。 主 要 的 区 别 在 于 ,我们 需要 给 它 添加 
一 些 动态 内 容 , 也 就 是 说 ,我 们 需要 生成 已 发 布 的 消息 文本 。 因 此 ,我 们 不 能 只 使 用 静态 的 HTML， 
还 需要 动态 生成 一 些 HTML。 作为 第 一 次 尝试 , 我 们 将 创建 一 个 全 局 变量 , 它 包 含 一 个 消息 列表 。 
显示 页 面 时 ， 将 迭代 消息 列表 ， 并 把 它们 添加 到 页 面 上 。 




























































































chattwo/chattwo.py 


class ChatMessage(object): 
def __init__ (self, user, msg): 
self.user = user 
self.message = msg 
self.time = datetime.datetime.now() 


def __str__ (self): 
return "%s (%s): %s" % (self.user, self.time, self.message) 


Messages = [] 


class ChatRoomPage (webapp.RequestHandler): 
def get(self): 
self.response.headers["Content-Type"] = "text/html" 
self.response.out.write(""" 
<htm]l> 
<head> 
<title>MarkCC's AppEngine Chat Room</title> 
</head> 
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<body> 
<hi>Welcome to MarkCC's AppEngine Chat Room</h1> 
<p>(Current time is %s)</p> 
""" % (datetime.datetime.now())) 
# 输出 聊天 信息 集合 
global Messages 
for msg in Messages: 
self.response.out.write("<p>%s</p>" % msg) 
self.response.out.write(""" 
<form action="" method="post"> 
<div><b>Name: </b> 
<textarea name="name" rows="1" cols="20"></textarea></div> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"></input></div> 
</form> 
</body> 
</htm]l> 
""") 








虽然 处 理 POST 是 全 新 的 一 步 ， 但 是 webapp 框 架 使 其 很 容易 实现 。 在 GET 请 求 的 处 理 程序 中 ， 
我 们 实现 了 RequestHandler 的 一 个 子 类 ， 该 类 有 一 个 get 方 法 。 对 于 POST 请 求 ， 我 们 遵循 相同 
的 模式 : 实现 RequestHandler 的 一 个 方法 ， 在 这 个 例子 中 ， 是 post 方 法 。RequestHandler 超 
类 保证 当 post 被 调用 时 ， 该 对 象 的 字段 包含 我 们 想 从 请 求 中 看 到 的 所 有 内 容 。 为 了 从 生成 POST 
的 表单 的 字段 中 得 到 数据 ， 我 们 只 要 使 用 表单 中 指定 的 标签 ， 调 用 该 请 求 的 get 方 法 即 可 。 在 代 
码 中 ， 我 们 从 POST 请 求 得 到 用 户 名 和 消息 ， 并 使 用 它们 ; 我 们 会 创建 一 个 消息 对 象 ， 并 将 其 加 


入 全 局 消 ， 




















息 列表 中 。 


chattwo/chattwo.py 


def post(self): 
chatter = self.request.get("name") 
msg = self.request.get("message") 
global Messages 
Messages.append(ChatMessage(chatter, msg)) 


# 


将 消息 添加 到 聊天 室 后 ， 我 们 将 重 定 向 到 根 页 面 ， 刷 新 用 户 浏览 器 ， 显 示 包 含 新 消息 的 聊天 室 


self.redirect('/') 
现在 ,我 们 需要 将 它 组 装 成 一 个 应 用 程序 。 分 为 两 步 : 首先 ,我 们 需要 编写 Python 代码 ， 创 
建 应 用 程序 对 象 ， 并 将 请 求 映射 到 我 们 编写 的 请 求 处 理 程序 上 ; 第 二 ， 我 们 需要 编写 app.yam] 
文件 。 然 后 ， 我 们 就 可 以 测试 该 应 用 程序 了 。 
app.yam] 文 件 和 之 前 的 几乎 完全 一 样 。 我 修改 了 这 个 新 示例 的 Python 文件 名 称 , 所 以 需要 将 
app.yam] 文 件 中 的 script 项 更 改 为 新 名 称 。 


chattwo/app.yaml 




















application: markcc-chatroom-one 
version: 1 

runtime: python 

api_version: 1 
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handlers: 
- Url: /.* 
script: chattwo.py 


以 下 是 Python 的 webapp 的 粘 合 代码 : 


chattwo/chattwo.py 


chatapp = webapp.WSGIApplication([('/', ChatRoomPage)]) 


def mainO): 





run_wsgi_app (chatapp) cu 
if name == "__main__": 
main(C) 


现在 ,， 当 我 们 运行 该 程序 时 ( 和 上 一 章 一 样 , 使 用 dev_appserver.py )， 就 得 到 一 个 简单 
的 、 可 正常 工作 的 聊天 室 。 来 吧 , 试 一 下 。 它 使 用 dev_appserver .py 工作 得 非常 漂亮 ! 因此 ， 
我 们 现在 可 以 把 它 上 传 到 App Engine 的 服务 器 上 。 和 之 前 一 样 ， 我 们 使 用 appcfg .py 将 其 上 传 
到 App Engine。 

你 可 以 看 到 图 3-2 中 的 结果 。 它 看 起 来 几乎 和 运行 在 本 地 开发 服务 器 上 完全 一 样 。 我 使 用 两 
个 不 同 的 用 户 名 发 送 了 一 些 消息 ， 并 得 到 了 很 好 的 聊天 记录 。 





Welcome to MarkCC's AppEngine Chat Room 


(Current time is 2009-07-02 01:43:13.554471) 

MarkCC (2009-07-02 01:42:49.129927): Hello, is there anybody out there? 

Prag (2009-07-02 01:42:56.823207): Yup, I'm here. 

MarkCC (2009-07-02 01:43:13.468926): Good. Im working on chapter 3, and testing the chat code. 


Name: | 


Message 





Send ChatMessage 























图 3-2 ”活动 的 聊天 室 应 用 程序 


然后 , 我 需要 休息 一 下 ,去 给 我 儿子 洗澡 ,并 把 他 送 回 到 床上 。 回 来 时 ,我 又 发 送 了 为 一 条 
消息 。 你 可 以 从 图 3-3 中 看 到 结果 。 

当 我 发 送 新 消息 时 ， 所 有 的 旧 消 息 都 不 见 了 ! 聊天 记录 里 除了 我 刚刚 增加 的 新 消息 外 没有 
其 他 内 容 。 我 们 没有 编写 任何 代码 来 删除 旧 消 息 ， 事 实 上 ， 我 们 的 代码 根本 没有 删除 消息 的 功 
能 ， 我 们 只 是 不 断 地 将 消息 添加 到 聊天 室 中 。 那 么 ， 之 前 的 聊天 记录 发 生 了 什么 事 ? 旧 消 息 哪 
里 去 了 ? 
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Welcome to MarkCC's AppEngine Chat Room 


(Current time is 2009-07-02 01:46:22.908668) 
MarkCC (2009-07-02 01:46:22.842850): Hi Im back, kids in bed. 


Name: 


Message 


Send ChatMessage 














图 3-3 ”休息 后 的 聊天 室 应 用 程序 


它们 哪儿 都 没 去 , 我 们 遇 到 了 云 代 码 和 普通 代码 的 一 个 基本 的 、 重 要 的 差别 。 当 开发 者 为 自 
己 的 服务 器 编写 代码 时 ， 知 道 每 个 请 求 都 会 被 自己 的 服务 絮 处 理 。 如 果 使 用 Python 解 释 器 ， 并 发 
送 消息 给 解释 器 处 理 ， 那 么 ， 只 要 开发 者 需要 ，Python 解 释 器 就 在 那里 。 

而 当 开发 者 向 云 服 务 器 发 送 一 条 消息 , 它 就 会 被 路 由 到 某 个 云 数 据 中 心 的 某 台 服务 器 上 。 你 
无 法 确保 任意 两 条 消息 被 路 由 到 相同 的 服务 器 上 , 甚至 不 能 保证 是 同一 块 大 陆 的 服务 器 上 。 即 使 
它们 恰好 集中 在 同一 台 服 务 器 上 , 也 不 能 保证 这 台 云 服务 器 上 的 Python 解释 器 会 一 直 运 行 你 的 代 
码 。 在 类 似 webapp 的 基于 云 的 编程 框架 里 , 请求 处 理 程 序 是 无 状态 的 , 也 就 是 说 开发 者 不 能 指望 
在 处 理 不 同 请 求 时 , 变量 里 包含 的 是 之 前 设 定 的 值 。 开发 者 需要 在 编程 时 假设 每 个 请 求 都 使 用 一 
个 全 新 的 Python 解释 器 运行 。 

该 应 用 程序 之 所 以 能 够 正常 工作 纯粹 是 靠 运气 。 当 我 们 在 本 地 运行 该 程序 时 , dev_appserver 
只 使 用 一 个 单一 的 Python 解释 器 ,因此 应 用 程序 能 在 本 地 运行 良好 。 当 我 们 把 它 上 传 到 App Engine 
服务 器 上 时 ， 它 就 运行 在 云 里 。App Engine 接 收 到 第 一 个 请 求 ， 就 开始 运行 一 个 Python 解释 器 ， 
并 且 使 用 该 解释 器 运行 请 求 。 当 我 提交 一 个 消息 , 会 向 App Engine 发 送 第 二 个 请 求 。 主 App Engine 
服务 器 会 看 到 数据 中 心 处 理 器 上 有 一 个 Python 解释 器 ， 这 个 解释 器 刚刚 处 理 了 该 应 用 程序 的 请 
求 ， 而 且 解 释 器 并 不 忙 ， 因 此 ， 它 会 将 第 二 个 请 求 路 由 到 那个 解释 器 。 

但 后 来 ,我 休息 了 一 会 儿 ， 并且 离 开 电 脑 十 五 分 钟 。 在 此 期 间 ，App Engine 服 务 注意 到 运行 
我 的 聊天 应 用 程序 的 Python 解 释 器 已 经 空闲 一 会 儿 了 ， 所 以 它 自动 关闭 了 。 等 我 提交 接 下 来 的 消 
息 时 ， 没 有 活动 的 、 正 在 运行 聊天 室 代码 的 Python 解释 器 ， 因 而 App Engine 服 务 启动 了 一 个 新 的 
解释 器 。 

要 解决 这 样 的 问题 ， 当 为 App Engine 构 建 云 应 用 程序 时 ， 就 需要 明确 地 知道 如 何 管理 在 不 
同 请 求 之 间 共 享 的 数据 。 我 们 不 能 依赖 模块 或 类 变量 来 管理 应 用 程序 的 状态 : 每 当 我 们 改变 应 
用 程序 时 ， 必 须 显 式 地 存放 应 用 程序 的 所 有 数据 ; 而 当 我 们 想 要 访问 应 用 程序 时 ， 必 须 显 式 地 
取 回 数据 。 

必须 牢记 的 一 点 是 , 开发 者 在 云 应 用 中 不 要 腾 测 基本 的 数据 管理 方式 , 而 是 需要 显 式 的 数据 
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管理 。 幸 运 的 是 ，webapp 提 供 了 一 种 非常 好 的 、 持 和 久 性 服务 ， 称 为 数据 仓库 (datastore )。 我 会 
在 下 一 章 中 描述 数据 仓库 。 
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口 RFC 2616: 超 文 本 传输 协议 , HTTP/1.1, http:/www.w3.org/Protocols/rfc2616/rfc2616.html。 
W3C 的 HTTP 1.1 协 议 标准 。 
口 维基 百科 关于 HTTP 的 文章 ，http://en.wikipedia.org/wiki/Http。 
一 个 人 简明、 全面、 非 正式 的 HTTP 描 述 。 
DD Django, http:/www.djangoproject.com/。 
Django 是 一 种 广泛 使 用 的 网 络 服务 开发 平台 。 它 是 Google App Engine 可 供 选 择 的 框架 之 
一 。 很 多 App Engine 的 设施 都 是 在 Django 框 架 上 建 模 而 来 ， 或 者 是 借鉴 了 Django 框 架 。 
口 Django Nonrel, http://www.allbuttonspressed.com/projects/django-nonrel。 
Django Nonrel] 是 Django 的 一 个 变种 , 它 试 图 让 Django 在 不 基于 关系 数据 库 的 平台 上 使 用 起 
来 更 容易 ， 就 像 App Engine。 




















云 中 的 数据 管理 








在 这 一 章 中 , 我 们 来 修改 聊天 应 用 程序 , 通过 使 用 Google App Engine 的 数据 仓库 来 实现 持久 
性 存储 ， 在 这 个 过 程 中 了 解 云 应 用 程序 中 存储 和 管理 数据 的 常见 问题 。 


4.1 聊天 软件 为 何不 工作 ? 


在 上 一 章 结 束 时 , 我 们 的 聊天 应 用 程序 有 一 个 问题 。 它 似乎 是 可 以 工作 的 , 但 是 如 果 我 们 停 
止 使 用 几 分 钟 ， 然 后 再 回来 ， 它 便 丢失 了 聊天 历史 记录 。 

原因 是 我 们 的 聊天 应 用 程序 现在 依赖 全 局 变量 存储 聊天 历史 记录 。 但 是 当 我 们 在 云 中 运行 应 
用 程序 时 ， 该 方法 并 不 可 行 : 全 局 变量 的 数据 在 各 个 请 求 之 间 不 一 定 能 够 保留 。 

首先 要 问 的 问题 是 : 为 什么 呢 ? 云 应 用 程序 的 哪些 因素 迫使 我 们 要 用 不 同 的 方式 处 理 数据 ? 

开发 者 在 自己 的 计算 机 上 运行 应 用 程序 时 , 操作 系统 创建 一 个 进程 。 进 程 分 配 一 些 内 存 用 于 
存储 , 在 内 存 中 存放 程序 所 有 的 数据 。 进 程 继 续 在 计算 机 上 运行 ,同时 ， 也 继续 使 用 着 操作 系统 
分 配给 它 的 内 存 , 直到 开发 者 退出 该 进程 。 如 果 开 发 者 使 用 一 会 儿 应 用 程序 ， 然 后 离开 做 些 其 他 
的 事情 ， 之 后 再 回来 继续 运行 ， 它 仍然 是 同一 个 进程 ， 访 问 着 同样 的 内 存 。 

云 则 是 个 完全 不 同 的 世界 。 开 发 者 业已 习惯 的 规则 , 即使 像 变量 的 工作 方式 这 样 简单 的 事情 ， 
都 有 很 大 的 不 同 。 这 个 程序 不 是 运行 在 开发 者 的 计算 机 上 , 天 晓得 它 运行 在 哪个 或 哪些 计算 机 上 ， 
这 些 计算 机 也 不 知道 位 于 哪个 与 网 络 相连 的 数据 中 心 内 。 我 们 编写 了 一 个 云 应 用 程序 ， 并 使 用 
Google App Engine 的 服务 将 其 上 传 。 从 我 们 这 样 做 的 那 一 刻 起 ,程序 就 在 运行 , 但 是 它 的 运行 并 
不 像 开 发 者 在 以 往 使 用 桌面 计算 机 时 所 期 望 的 那样 。 一 个 程序 在 云 中 “正在 运行 ”可 能 并 不 是 真 
正 运行 于 某 台 计算 机 上 。 实 际 上 ,在 我 写 到 这 里 时 ， 我 已 经 完成 了 Python 聊天 室 应 用 程序 的 最 终 
版 本 ， 并 上 传 到 了 App Engine 一 一 并 且 ， 它 确实 没有 运行 在 任何 一 台 计 算 机 上 ! (那么 , 我 是 怎 
么 知道 的 呢 ? 因为 几 周 前 我 上 传 了 该 程序 , 而 且 我 至 少 一 周 没有 在 浏览 器 上 加 载 过 该 页 面 。 所 以 ， 
现在 ，App Engine 服 务 器 绝对 没有 在 任何 计算 机 上 加 载 过 它 。 但 是 ， 如 果 我 在 浏览 器 上 加 载 该 聊 
天 应 用 程序 的 页 面 ，App Engine 就 会 加 载 它 来 处 理 我 的 请 求 。) 

正如 前 面 章 节 内 容 所 述 ， 云 应 用 是 围绕 请 求 处 理 构建 的 。 如 果 没 有 等 待 处 理 的 请 求 ， 程序 就 
没有 必要 在 任何 计算 机 上 运行 了 ; 如 果 有 人 少数 请 求 到 来 , 在 一 台 计算 机 上 运行 程序 可 能 就 足够 了 ; 
如 果 开 发 者 的 应 用 程序 得 到 了 Slashdot 网 站 的 关注 ， 被 它 提 到 过 ， 则 可 能 需要 上 千 台 机 咒 来 处 理 
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所 有 收 到 的 请 求 ! 对 于 程序 而 言 ， 这 是 云 之 所 以 有 趣 的 地 方 之 一 : 它 给 开发 者 提供 了 一 个 具有 自 
扩展 性 的 平台 。 

当然 , 这 是 有 代价 的 。 如 果 程 序 可 以 在 多 台 计 算 机 上 运行 ,或 者 它 没有 在 任何 一 台 计 算 机 上 
运行 ， 那么， 开发 者 就 不 能 确定 当代 码 开始 处 理 请 求 时 ， 内 存 里 实际 存储 的 是 什么 。 

当 程 序 开始 处 理 请 求 时 ， 开 发 者 不 能 依赖 于 其 应 用 程序 的 请 求 处 理 程序 在 内 存 中 保留 的 数 
据 。 那么 ， 在 开发 者 处 理 请 求 时 ， 必 须 将 每 个 将 来 可 能 要 查看 的 数据 显 式 地 保存 在 一 个 共享 存 
储 区 域内 ， 该 区 域 被 称 为 持久 性 存储 。 开 发 者 在 处 理 请 求 时 要 用 到 的 每 个 数据 必须 从 持久 性 存 
储 中 取 回 。 























云 : 函数 式 程序 设计 ? 

云 作为 一 种 开发 环境 ， 带 动 了 函数 式 程序 设计 风格 的 普及 。 在 函数 式 程 序 设 计 中 ， 开 
发 者 不 允许 存储 不 稳定 状态 。 换 而 言 之 ， 开 发 者 不 能 够 使 用 赋值 语句 修改 变量 值 。 因 而 ， 
开发 者 不 能 存放 任何 在 同一 个 函数 的 不 同调 用 之 间 进 行 共 享 的 数据 。 开 发 者 必须 通过 参数 
显 式 地 传递 函数 所 需要 的 所 有 数据 。 这 样 的 风格 对 于 云 编 程 而 言 ， 是 非常 自然 的 。 

如 果 开 发 者 不 习惯 这 种 风格 ， 可 能 会 认为 函数 式 程序 设计 看 起 来 很 不 自然 ， 也 非常 难 
以 掌握 。 但 它 其 实 并 非 如 此 一 实际 上 ， 一 旦 习惯 了 函数 式 程序 设计 ， 它 就 具有 了 十 足 的 


吸引 力 ! 而 且 ， 开 发 者 的 应 用 程序 越 复杂 ， 函 数 式 的 风格 就 越 具有 吸引 力 。 

在 Google， 我 们 一 般 使 用 3 种 语言 编程 : C++、JjJava 和 Python。 这 些 都 不 是 函数 式 程 
序 语言 ， 而 都 是 重 状态 的 、 规 则 式 的 、 面 向 对 象 的 程序 语言 。 但 是 我 在 这 种 代码 基础 上 阅 
读 和 编写 的 代码 越 多 ， 就 越发 现 函 数 式 编程 是 构建 大 型 程序 的 最 好 方式 。 我 发 现 如 果 代码 
基本 上 有 是 函数 式 的 ， 就 更 容易 理解 和 测试 ， 而 且 不 太 可 能 产生 令 人 痛苦 的 错误 。 这 就 是 为 
什么 当 我 看 到 代码 不 是 函数 式 时 会 有 些 晴 缩 的 原因 。 我 编写 的 几乎 所 有 程序 ， 最 后 大 都 是 
函数 式 的 一 一 现在， 我 只 有 在 编程 语言 和 编译 器 不 能 保持 代码 效率 ,无 法 完成 任务 目标 时 ， 
才 使 用 非 函 数 式 代码 。 











我 们 如 何 使 用 永久 型 存储 开展 工作 呢 ? 这 是 云 编程 与 老式 的 本 地 应 用 程序 的 本 质 不 同 之 处 。 
当 开 发 者 开始 编写 云 应 用 程序 时 , 其 过 程 看 起 来 累 玲 有 昌 令 人 泪 表 ,但 这 并 不 是 一 件 坏事 ,事实 上 ， 
开发 者 的 应 用 程序 由 无 状态 的 各 部 分 组 成 , 这 会 有 极 好 的 效果 , 这 是 使 程序 具有 可 扩展 性 的 关键 。 
如 果 应 用 程序 每 5 秒 处 理 一 个 请 求 ， 在 一 台 计 算 机 上 将 其 作为 Python 应 用 程序 运行 ， 会 工作 得 很 
好 。 开发 者 能 够 使 用 全 局 变量 表示 数据 , 并 且 不 需要 处 理 特殊 的 持久 性 存储 , 就 能 得 到 所 有 结果 。 
但 是 ， 如 果 应 用 的 用 户 越 来 越 多 ， 会 发 生 什么 事情 呢 ? 每 秒 1 个 请 求 ” 没 问 题 。 每 秒 10 个 呢 ? 没 
问题 。 每 秒 100 个 呢 ? 可 能 开始 有 点 困难 了 。 每 秒 1000 个 呢 ?9 10 000 个 呢 ? 100 000 个 呢 ? 迟早 在 
某 个 点 ， 应 用 程序 会 骨 泪 ， 它 无 法 处 理 所 收 到 的 大 量 请 求 。 但 是 在 云 中 ， 随 着 请 求 数量 的 增加 ， 
运行 应 用 程序 的 机 器 的 数量 也 能 够 增加 , 所 以 不 管用 户 请 求 的 速度 如 何 , 开发 者 总 有 能 力 处 理 这 
些 请 求 。 一 个 良好 的 永久 型 存储 机 制 意味 着 开发 者 不 需要 关心 有 多 少 台 机 器 正在 运行 其 程序 , 无 
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论 是 一 台 、 十 台 还 是 一 千 台 机 器 都 没有 任何 区 别 。 在 我 自己 的 工作 项 目 中 , 我 的 代码 每 晚 在 由 数 
千 台 机 器 组 成 的 网 络 上 运行 。 在 那样 的 环境 中 , 使 用 全 局 变量 共享 数据 显然 是 荒 户 的 : 我 的 Python 
程序 里 对 一 个 全 局 变量 的 赋值 怎么 可 以 被 一 千 台 机 器 共享 ” 但 是 因为 系统 使 用 了 永久 型 存储 , 所 
以 这 根本 不 是 问题 。 当 系统 的 一 部 分 变 得 很 慢 , 并 且 开 始 超过 其 执行 期 限时 , 我 只 需 改变 一 个 配 
置 文件 ,声明 它 能 够 使 用 的 最 大 的 机 器 数量 就 可 以 了 ,而且 ,这 就 是 我 需要 做 的 所 有 工作 。 程 序 
开始 在 更 多 机 右上 运行 ， 也 会 更 快 地 执行 完 。 


























云 中 的 通用 数据 管理 
每 个 云 编程 系统 都 提供 了 某 种 存储 永久 型 数据 的 机 制 . 尽 管 确切 的 机 制 不 尽 相 同 ,但 是 ， 
基本 机 制 几乎 都 类 似 于 数据 库 。 有 些 系统 使 开发 者 可 以 访问 小 型 的 、 快 速 的 数据 库 系 统 (如 


MySQL )， 有 些 系统 则 提供 了 更 灵活 的 、 类 似 数据 库 的 存储 方式 ， 如 App Engine。 虽 然 本 书 
中 我 们 只 了 解 App Engine 的 数据 仓库 机 制 ， 但 是 ， 持 久 性 存储 还 有 很 多 其 他 实现 ， 其 中 一 
些 也 可 以 用 于 App Engine 程序 。 





4.2 ”聊天 软件 的 持久 性 改造 


Google App Engine 有 一 个 定制 的 数据 持久 性 系统 ， 称 为 App Engine 数 据 仓库 ( App Engine 
datastore )。App Engine 数据 仓库 非常 类 似 于 数据 库 ， 只 是 对 于 像 Python 对 象 这 类 数据 而 言 ， 使 用 
起 来 更 加 简单 。 与 关系 数据 库 不 同 的 是 , 数据 仓库 不 需要 严格 的 数据 模式 ; 对 于 开发 者 存储 和 管 
理 持 久 性 数据 而 言 ,数据 仓库 非常 灵活 ,并 且 是 动态 的 .为 了 用 Python 检索 并 获取 数据 ,App Engine 
提供 了 一 个 自 定义 的 查询 语言 , 称 为 GQL。GQL 看 起 来 和 用 于 查询 传统 关系 数据 库 的 SQL 语言 非 
常 相似 , 但 是 它 是 为 使 用 数据 仓库 对 象 而 不 是 关系 表 定制 的 。 开发 者 并 非 必 须 使 用 GQL 进 行 数据 
仓库 相关 的 工作 ， 但 是 GQL 确 实 非常 适合 这 项 任务 ， 并 日 易于 使 用 。 























GOQL 和 数据 仓库 

如 果 开 发 者 之 前 使 用 过 关系 数据 库 ， 就 会 知道 ，SQL 查询 语言 是 数据 库 密 不 可 分 的 一 
部 分 。SQL 是 用 户 与 数据 库 交 互 的 唯一 途径 。 在 数据 库 中 ， 所 有 的 数据 都 存储 在 关系 表 中 ， 
用 户 通过 SQL 实现 对 这 些 数据 库 表 的 每 个 操作 。 正 因为 如 此 ， 对 关系 数据 库 编程 人 员 来 讲 ， 


SQL 和 数据 库 实 际 上 近乎 是 同一 事物 。 

在 Google App Engine 的 数据 仓库 中 ， 工 作 方式 根本 不 是 这 样 的 。App Engine 提供 了 一 
个 基本 的 存储 引擎 ， 允 许 用 户 存储 对 象 和 数据 。 该 存储 系统 根本 没有 查询 语言 。 数 据 仓 库 
只 是 一 个 大 容量 、 大 规模 并 行 存储 系统 。 

在 内 部 ， 数 据 仓库 使 用 索引 来 协助 迅速 完成 查询 工作 。 通 常情 况 下 ， 在 App Engine 开 
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发 环境 中 ， 索 引 有 是 基于 开发 者 所 运行 的 测试 自动 生成 的 。 开 发 者 也 可 以 构建 自己 的 索引 ， 

我 们 将 在 第 在 内 部 ,数据 仓库 使 用 索引 来 协助 迅速 完成 查询 工作 ,通常 情况 下 ,在 App Engine 
开发 环境 中 ， 索 引 是 基于 开发 者 所 运行 的 测试 自动 生成 的 。 开 发 者 也 可 以 构建 自己 的 索引 ， 
我 们 将 在 第 14 章 中 了 解 该 内 容 。GQL 是 一 种 查询 语言 ， 专 门 用 来 处 理 数据 仓库 和 索引 。 基 
本 上 ，GQL 就 是 数据 仓库 索引 的 一 个 封装 ， 它 是 一 个 便捷 的 、 轻 量 级 的 查询 语言 ， 可 以 党 


不 费力 地 查找 数据 仓库 的 索引 。 它 并 不 是 数据 仓库 的 一 部 分 ， 而 只 是 一 个 帮助 开发 者 使 用 
数据 仓库 的 有 效 的 函数 库 。 

理解 了 GQL 的 使 用 目的 ， 我 们 也 就 能 从 中 领会 到 GQL 的 工作 原理 。GQL 不 是 数据 仓 
库 的 组 成 部 分 ， 它 只 是 一 个 协助 用 户 使 用 数据 仓库 索引 的 工具 。 





4.2.1 创建 和 存储 持久 性 对 象 


数据 仓库 有 很 多 选项 , 开发 者 可 以 选择 最 适合 自己 应 用 程序 的 方式 开展 工作 。 基 本 的 数据 仓 
库 操 作 很 简单 ， 由 于 开发 者 对 数据 仓库 的 使 用 越 来 越 多 , 在 需要 时 , 也 可 以 逐渐 使 用 其 更 多 复 困 
的 功能 。 现 在 ， 我 们 仍然 从 基础 开始 。 

通常 ， 采 用 App Engine 的 数据 仓库 与 采用 Python 编程 有 很 大 的 区 别 。 通 常情 况 下 ， 当 开发 者 
用 Python 创建 一 个 类 时 ， 并 不 需要 声明 类 的 各 个 字段 ， 只 要 赋值 ， 这 些 字 段 就 自动 创建 了 。 而 要 
使 用 数据 仓库 ， 开 发 者 就 不 得 不 舍弃 一 些 灵活 性 。 采 用 数据 仓库 ， 开 发 者 必须 创建 对 象 的 模型 
( model ), 告诉 数据 仓库 对 象 有 哪些 字段 ， 以 及 这 些 字段 都 有 什么 类 型 的 值 。( 实际 上 , 开发 者 似 
乎 可 以 采用 一 种 名 为 expando 模 型 的 Python 编程 风格 ， 该 模型 可 以 在 需要 时 再 赋值 ， 但 是 开发 者 
确实 不 应 该 使 用 这 种 方式 。 对 于 云 应 用 程序 而 言 ， 开 发 者 应 该 认真 考虑 自己 的 数据 ,并 为 其 定义 
一 个 适当 的 模型 。) 

背景 介绍 已 经 足够 了 。 掌握 App Engine 数 据 仓 库 的 最 简单 方法 就 是 直接 深入 其 中 , 分 析 代 码 。 
正如 前 面 所 说 ， 在 数据 仓库 中 ， 开 发 者 需要 定义 一 个 模型 ， 告 诉 数据 仓库 各 个 对 象 的 相关 内 容 。 
在 Python 中 ， 模 型 是 一 个 类 对 象 ， 它 是 db .Mode1 的 一 个 子 类 ， 其 中 ， 各 个 字段 是 通过 创建 模型 
类 的 类 成 员 来 定义 的 。 这 是 一 种 笨拙 的 、 非 Python 的 做 法 。 下 面 ， 我 从 聊天 应 用 程序 取出 
ChatMessage， 并 将 其 转变 为 一 个 数据 仓库 模型 : 





































































































persist-chat/pchat.py 


class ChatMessage(db.Model): 
user = db.StringProperty(required=True) 
timestamp = db.DateTimeProperty(auto_now_add=True) 
message = db.TextProperty(required=True) 


def__str__ (self): 
return "%s (%s): %s" % (self.user, self.timestamp, self.message) 
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在 App Engine 的 数据 仓库 中 ， 一 个 模型 定义 了 一 组 命名 的 特性 (properties ) 集合 。 开 发 者 通 
过 创建 db .Mode1 的 子 类 来 定义 一 种 可 存储 的 对 象 ， 并 且 ， 通 过 给 类 本 身 的 类 变量 赋 以 适当 的 类 
型 来 定义 该 对 象 的 特性 。 数 据 仓库 支持 很 多 数据 类 型 : 字符 串 、 数 字 、 日 期 、 列 表 、 引 用 等 。 它 
甚至 让 开发 者 定义 自己 的 可 存储 对 象 的 新 类 型 。 我 们 在 第 13 章 中 , 会 进一步 讨论 开发 者 可 以 实现 
哪些 复杂 工作 。 
我 们 的 聊天 消息 有 三 个 字段 : 一 个 包含 发 送 消息 的 用 户 名 称 的 字符 串 、 一 个 包含 消息 的 字符 
串 ， 以 及 表明 消息 何 时 发 送 的 时 间 标 签 。 每 个 字段 都 被 声明 为 一 个 特性 。 
口 User 用 户 名 只 是 一 个 字符 串 特性 。 每 条 消息 都 必须 有 一 个 用 户 名 ， 所 以 我 们 通过 关键 
字 参 数 required=true 指 定 它 不 能 为 空 。 在 数据 仓库 中 , 字符 串 特性 的 值 就 是 一 个 Python 
字符 串 ， 不 能 超过 500 个 字符 。 
D time 时 间 特 性 是 db.DateTimeProperty 的 一 个 实例 ， 表 明 该 特性 的 值 是 Python 中 
datetime 的 一 个 实例 。 对 于 这 个 特性 ， 我 们 可 以 使 用 一 个 有 趣 的 功能 ， 就 是 数据 仓库 使 
用 Python 类 表示 特性 所 用 的 方法 。 每 条 消息 都 应 该 有 一 个 时 间 标 签 , 但 是 我 们 并 不 想 在 创 
建 一 条 消息 时 必须 指明 时 间 戳 ， 而 是 希望 时 间 截 就 是 现在 一 一 也 就 是 说 ， 该 消息 被 应 用 
程序 收 到 的 时 间 。 因 此 ， 我 们 为 该 特性 添加 了 一 个 特殊 的 关键 字 参 数 auto_now_add， 表 
明 “ 如 果 在 该 模型 类 型 的 实例 被 创建 时 ， 该 特性 未 被 显 式 地 初始 化 ,那么 自动 将 其 初始 
化 为 当前 时 间 ”。 因 为 该 特性 由 Python 类 的 一 个 实例 表示 ， 该 类 可 以 被 定义 为 可 定制 的 初 
始 化 参数 ， 从 而 提供 了 类 型 特定 的 功能 ， 如 auto_now_add， 而 不 需要 任何 特殊 的 原型 。 
在 第 13 章 中 讨论 高 级 数据 仓库 的 话题 时 ， 用 户 将 会 了 解 到 如 何 定义 自己 的 、 新 的 特性 类 
型 ， 并 且 提 供 自 己 的 类 型 特定 的 扩展 功能 。 
D message 最后， 我 们 来 看 一 下 消息 的 内 容 。 和 user 字 段 一 样 ，message 也 是 一 个 必需 
的 字符 串 特性 。 但 是 在 数据 仓库 里 ， 字 符 串 不 能 超过 500 个 字符 。 可 能 大 多 数 的 聊天 消息 
比 这 个 长 度 短 ， 但 并 不 是 所 有 的 聊天 消息 都 小 于 500 个 字符 。 因 此 ， 我 们 没有 使 用 
db.StringProperty， 而 是 使 用 db.TextProperty。 这 是 一 个 想 要 多 长 就 可 以 多 长 的 字 
符 串 ， 但 是 因为 它 可 以 是 任意 长 度 ， 所 以 开发 者 不 能 用 它 来 进行 排序 或 搜索 。 
因为 我 们 已 经 通过 描述 实例 所 需要 的 信息 创建 了 一 个 模型 , 所 以 现在 不 需要 提供 我 们 自己 的 
初始 化 方法 了 。db .Mode1 会 基于 我 们 声明 的 类 的 各 个 字段 的 特性 名 称 和 类 型 和 月 动 生成 一 个 包括 
关键 字 参 数 和 类 型 的 初始 化 程序 。 
我 们 已 经 有 了 一 个 可 存储 类 ， 如 何 实际 存储 数值 呢 ? 再 简单 不 过 了 : 作为 db.Mode1 的 子 类 
的 实例 ， 每 个 对 象 提供 了 一 个 没有 参数 的 方法 ， 该 方法 名 称 为 put。 如 果 开 发 者 调用 了 一 个 对 象 
的 put 方 法 ， 这 个 对 象 就 被 存储 到 此 应 用 程序 的 数据 仓库 中 。 下 面 是 我 们 POST 处 理 程序 的 修改 版 
本 ， 它 创建 了 ChatMessage 类 的 一 个 实例 ， 然 后 ， 在 msg.put() 处， 存储 了 新 的 聊天 消息 
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class ChatRoomPoster (webapp.RequestHandler): 
def post(self): 
chatter = self.request.get("name") 
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msgtext = self.request.get("message") 

msg = ChatMessage(user=chatter, message=msgtext) 
0 msg.put() 

# 现在 我 们 已 将 消息 加 到 聊天 内 容 中 ， 然 后 重 定向 到 根 页 面 

self.redirect('/') 


就 是 这 样 。 在 模型 实例 上 调用 put Q 〇 将 实例 存储 到 数据 仓库 中 ,并且 使 其 可 用 于 查询 和 取 回 。 


4.2.2” 取 回 持 久 性 对 象 

我 们 需要 知道 的 最 后 一 件 事情 就 是 如 何 取 回 所 存储 的 数据 。 下 面 是 我 们 的 GET 处 理 程序 的 一 
部 分 ， 用 于 从 数据 仓库 取 回 所 有 的 消息 ; 该 方法 的 其 余部 分 , 也 就 是 其 他 的 所 有 代码 ， 取 回 消息 
并 打印 ， 则 一 点 都 没 变 。 
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# 输出 聊天 消息 集合 
messages = db.GqlQuery("SELECT * From ChatMessage ORDER BY time") 
for msg in messages: 

self.response.out.write("<p>%s</p>" % msg) 


开发 者 可 以 使 用 GQL 查 询 语言 取 回 数据 。 正 如 代码 中 所 示 ,，GQL 和 SQL 有 很 多 相似 之 人 处。 最 
大 的 区 别 是 GQL 不 对 表 查 询 ， 它 查询 的 是 模型 类 型 。 我 们 的 聊天 室 中 的 查询 ， 选 择 的 是 
ChatMessage 的 所 有 实例 ， 而 不 是 表 中 的 所 有 行 。 

根据 开发 者 要 查询 的 内 容 , 有 时 很 明显 需要 使 用 不 同 的 GQL 风 格 。 开 发 者 通过 调用 模型 类 的 
gdq] 方 法 ， 可 以 省 略 查询 中 的 SELECT * FROM type 部 分 。 例 如 ， 在 我 们 上 边 的 代码 中 ，GQL 查 
询 也 可 以 写成 ChatMessage.gq1("ORDER BY timestamp")。 


4.2.3 ”使 用 GQL 查 询 改 进 聊 天 软件 


我 们 的 聊天 应 用 程序 有 一 个 问题 ， 它 很 元 长 。 现在， 用 户 每 次 刷新 聊天 显示 ， 就 会 看 到 整个 
聊天 内 容 。 当 对 话 已 经 持续 一 段 时 间 以 后 , 这 一 过 程 就 会 变 得 很 长 ,而 用 户 感 兴趣 的 是 最 近 一 段 
时 间 的 那 部 分 聊天 内 容 ， 也 就 是 总 在 页 面 底 端的 那 部 分 内 容 。 

聊天 室 的 用 户 不 想 又 不 得 不 经 常 滚动 至 他 们 以 前 已 经 看 过 的 消息 。 大 多 数 时 候 , 他 们 知道 之 
前 说 过 什么 ， 只 想 看 到 最 新 的 消息 。 例 如 ， 他 们 可 能 只 想 看 到 该 聊天 室 的 最 后 二 十 条 消息 ， 或 者 
只 想 看 到 最 后 五 分 钟 内 发 布 的 消息 。 

使 用 GQL， 在 GQL 查 询 语句 中 增加 一 些 子 句 修正 这 个 见长 的 问题 简直 轻而易举 。 要 看 到 最 
近 二 十 条 消息 ， 我 们 可 以 添加 一 个 LIMIT 子 句 ; 要 看 到 最 后 五 分 钟 的 消息 ， 我 们 可 以 添加 一 个 
WHERE 子 句 。 

当然 , 我 们 并 不 想 限 制 用 户 , 使 他 们 只 能 看 到 某 个 简洁 的 视图 一 一 当 他 们 第 一 次 进入 一 个 新 
的 聊天 室 时 ， 可 能 希望 看 到 整个 聊天 历史 记录 。 因 此 , 我 们 会 分 别 为 这 两 种 新 场景 ， 给 我 们 的 应 
用 程序 添加 新 的 处 理 程序 。 我 们 会 保留 完整 的 聊天 视图 , 并 给 时 间 限 制 和 计数 限制 的 精简 视图 增 
加 两 个 新 的 URL。 
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App Engine 数据 仓库 与 关系 数据 库 

讲 到 这 里 ， 数 据 仓 库 模 型 和 关系 数据 库 表 之 间 的 差异 可 能 听 起 来 并 不 大 。 毕 竟 ， 每 一 
个 ChatMessage 的 实例 是 完全 相同 的 : 它们 有 一 组 类 型 字段 ， 看 起 来 和 关系 数据 库 中 的 列 
很 像 。 乍 一 看 ， 数 据 仓 库 很 像 关 系数 据 库 ， 只 是 其 使 用 程式 化 的 Python 类 创建 表 ， 而 不 是 
使 用 SQL 的 CREATE TABLE 语句 。 
事实 上 ， 情 况 远 非 如 此 。 数 据 仓库 中 ， 数 据 类 型 和 数据 结构 的 范围 比 关系 数据 库 要 丰富 得 


多 。 在 数据 仓库 中 ， 我 们 可 以 有 一 个 包含 列表 类 型 特性 的 模型 ， 列 表 中 的 元 素 可 以 是 任何 
可 存储 的 值 ,并且 开发 者 可 以 将 列表 的 元 素 作为 GQL 查询 的 一 部 分 。 开 发 者 可 以 用 引用 特性 
来 描述 对 象 间 的 非 包含 链 接 ， 还 可 以 用 层次 型 、 树 状 结构 的 数据 类 型 ， 以 及 遍历 树 的 查询 。 
(这 并 不 是 说 数据 仓库 比 关 系数 据 库 好 ， 它 们 只 是 不 同 。 例 如， 关系 数据 库 的 合并 操作 的 性 
能 远 远 优 于 数据 仓库 ， 但 是 数据 仓库 可 以 让 开发 者 在 应 用 程序 中 使 用 熟悉 的 数据 结构 ， 使 
其 条 理 清 晰 ， 且 具有 可 扩展 性 。) 





4.2.4 添加 计数 限制 视图 


首先 ， 我 们 来 添加 计数 视图 。GQL 查 询 有 一 个 LIMIT 子 句 ， 可 指定 查询 结果 的 最 大 数目 。 例 
如 ， 当 用 户 声 明 LIMIT 20 时 ， 会 得 到 按照 指定 顺序 排序 的 、 与 查询 结果 匹配 的 前 20 个 值 。 由 于 
想 要 得 到 时 间 上 最 近 的 20 个 查询 结果 ， 需 要 确保 我 们 想 要 的 结果 排 在 前 边 。 我 们 按时 间 排 序 ， 最 
近 的 消息 先 显 示 ， 就 可 以 实现 这 个 效果 了 。 

计数 视图 使 用 RequestHandler 实 现 , 除了 有 两 行 不 同 外 , 其余 都 和 ChatRoomPage 相 同 。 
此 ， 我 复制 了 ChatRoomPage， 并 将 副本 改名 为 ChatRoomCountViewPage。 修 改 后 的 get 方 法 如 
下 所 示 : 
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class ChatRoomCountViewPage (webapp.RequestHandler): 
def get(self): 
self.response.headers["Content-Type"] = "text/html" 
self.response.out.write(""" 
<htm]l> 
<head> 
<title>MarkCC's AppEngine Chat Room (last 20)</title> 
</head> 
<body> 
<hi>Welcome to MarkCC's AppEngine Chat Room</h1> 
<p>(Current time is %s; viewing the last 20 messages.)</p> 
""" % (datetime.datetime.now())) 
# 输出 聊天 消息 集合 
0 messages = db.GqlQuery("SELECT * From ChatMessage ”+ 
"ORDER BY timestamp DESC LIMIT 20").fetch(20) 
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© messages.reverse() 
for msg in list(messages): 
self.response.out.write("<p>%s</p>" % msg) 
self.response.out.write(""" 
<form action="/talk”" method="post"> 
<div><b>Name: </b> 
<textarea name="name" rows="1" cols="20"></textarea></div> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 
</form> 
</body> 
</html> 
ey) 


只 有 以 下 两 处 真正 的 变化 。 
@ 在 查询 语句 中 ， 我 们 指定 排序 方式 为 降序 ， 所 以 发 布 到 聊天 室 的 最 近 20 条 消息 会 排 在 查 
询 结果 的 最 前 边 ( ORDER BY time DESC ), 同时 , 我 们 将 查询 结果 限制 为 20 个 ( LIMIT 20 )。 
@ 查询 语句 生成 了 按照 时 间 降 序 排列 的 消息 ， 最 近 的 消息 排 在 最 前 边 。 然 而 ， 当 我 们 的 用 
户 读 取 聊 天 记录 时 ， 这 仍 不 是 他 们 希望 看 到 的 顺序 当 用 户 查 看 聊天 记录 时 ， 希望 聊 天 
记录 按照 自然 顺序 出 现 ， 也 就 是 说 ， 最 近 的 消息 应 该 显示 在 最 后 。 所 以 ,我 们 需要 在 打 
印 出 来 之 前 将 查询 结果 反 序 。 








4.2.5 添加 时 间 限 制 视 图 


增加 基于 时 间 选 择 一 部 分 聊天 记录 的 视图 要 比 增加 计数 限制 的 视图 更 为 复杂 。 它 需要 在 查 
询 中 增加 比较 ， 并 且 遇 到 了 GQL 最 大 的 限制 之 一 : 在 GQL 查 询 中 ， 开 发 者 不 能 做 任何 计算 ,不 
能 使 用 如 x+1 这 样 的 表达 式 。 每 个 计算 都 需要 用 Python 代码 在 查询 语句 之 外 完成 ,然后 再 插 人 到 
查询 中 。 

此 外 ， 开 发 者 可 以 使 用 参数 的 地 方 是 有 限 的 。 一 般 情况 下 ， 开 发 者 只 能 在 查询 语句 的 WHERE 
子 句 中 使 用 参数 。 

要 想 真 正 理 解 这 两 个 限制 的 含义 , 我 们 需要 看 看 GQL 的 一 些 参数 。 一 个 参数 基本 上 是 查询 语 
名 里 的 一 个 槽 ， 我 们 可 以 在 槽 里 注入 一 个 Python 值 。 

例如 ,如果 我 们 想 让 计数 有 限 的 视图 支持 不 同 数量 的 消息 , 在 查询 语句 中 使 用 参数 看 起 来 就 
很 自然 : ChatMessage.gq1("ORDER BY time DESC LIMIT :1". 20) .:1 是 一 个 查询 语句 的 参 
数 , 将 被 查询 字符 串 后 跟着 的 第 一 个 未 命名 的 参数 蔚 换 ， 即 本 例子 中 的 20。 不 幸 的 是 ,我 们 不 能 
这 样 做 ， 开 发 者 在 LIMIT 子 句 中 不 能 使 用 参数 。 然 而 ， 我 们 仍然 可 以 使 用 Python 的 字符 串 完 成 替 
换 这 个 工作 : ChatMessage.gq1("ORDER BY time DESC LIMIT %s" % 20)。 

我 们 可 以 在 时 间 限 制 视 图 中 使 用 参数 是 因为 相关 参数 是 WHERE 子 句 的 一 部 分 。 要 实现 时 间 限 
制 视图 ,必须 进行 一 些 时 间 运 算 。 如 果 要 显示 最 后 五 分 钟 内 发 布 的 消息 , 我 们 会 在 查询 中 将 其 描 
述 为 类 似 以 下 的 内 容 :“ 时 间 标 签 大 于 当前 时 间 减 5 分 钟 的 所 有 消息 。” 

在 Python 中 ， 我 们 可 以 用 datetime 模 块 : datetime.now() - timedeltaCminutes=5) 
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来 表示 “当前 时 间 减 分钟” 要 在 查询 语句 中 使 用 , 我 们 只 需要 注入 一 个 参数 。 因 此 , 我 们 编 
写 为 ; 
ChatMessage.gql("WHERE timestamp > :fiveago ORDER BY time", 
fiveago=datetime.now() - timedelta(minutes=5)) 


这 就 是 要 做 的 全 部 事情 。 只 需 复制 ChatRoomPage， 将 其 重 命名 为 ChatRoomTimeViewPage 
即 可 ， 并 用 上 述 代 码 片段 替换 查询 语句 ， 这 样 就 实现 了 时 间 限 制 视 图 。 

参数 可 以 是 编号 或 命名 。 如 果 是 命名 ， 在 Python 调用 中 使 用 命名 参数 指定 它们 的 值 ， 如 同 我 
们 上 边 做 的 那样 。 如 果 是 编号 ,开发 者 只 需要 按 顺 序 指定 各 个 参数 。 例 如 ,我们 可 以 在 时 间 限 制 
视图 查询 语句 中 使 用 编号 参数 ,如 ChatMessage.gq1("WHERE timestamp > :1 ORDER BY time",， 
datetime.now() - timedelta(minutes=5))。 对 于 任何 给 定 的 查询 语句 ， 最 好 全 都 使 用 命名 
参数 或 者 全 都 使 用 位 置 识别 的 参数 ， 混 合 使 用 这 两 种 方式 则 容易 引起 困惑 。( 事实 上 ， 我 认为 大 
多 数 时 候 , 开发 者 应 该 完全 使 用 命名 参数 。 这 样 做 唯一 的 缺点 是 会 稍微 多 打点 字 , 但 是 它 使 代码 
更 清晰 ， 而 且 出 错时 ， 也 更 容易 发 现 。) 

当然 , 要 能 看 到 该 视图 并 对 其 进行 测试 , 我 们 需要 修改 WSGIApp1ication, 将 查询 指向 我 们 
的 两 个 限制 视图 。 现 在 , 我 们 的 应 用 程序 有 三 个 视图 : 完整 会 话 视图 、 时 间 限 制 视图 和 计数 限制 
视图 : 
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chatapp = webapp.WSGIApplication([('/', ChatRoomPage), 
('/talk', ChatRoomPoster), 
('/1limited/count', ChatRoomCountViewPage), 
('/1limited/time', ChatRoomTimeViewPage)]) 


我 们 还 没有 在 视图 间 切 换 的 好 方法 ， 而且 各 视图 的 实现 有 过 多 数量 的 宛 余 。 我 们 会 在 后 续 章 
节 中 学 习 如 何 消除 宛 余 。 但 到 此 为 止 ， 我 们 已 经 有 了 可 运行 的 程序 。 
4.3 ”参考 文献 和 资源 
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Google App Engine 的 登录 
认证 服务 











开发 者 用 App Engine 构 建 的 大 多 数 网 络 应 用 程序 必须 要 能 够 跟踪 用 户 的 使 用 。 开 发 者 需要 能 
够 让 用 户 进 行 登录 ， 并 根据 获得 的 权限 执行 操作 。 在 本 章 中 ,我 们 将 了 解 如 何 管理 用 户 ， 以 及 跟 
踪 哪 个 用 户 发 出 了 哪个 请 求 。 为 了 做 到 这 一 点 ,我 们 将 使 用 一 种 App Engine 的 服务 ， 这 种 服务 是 
独立 于 webapp 框 架 的 一 部 分 App Engine API。 








5.1 users 服务 简介 


我 们 的 聊天 系统 已 经 有 了 一 个 很 好 的 开端 , 但 它 的 功能 还 是 非常 有 限 。 我 们 开始 时 设计 了 支 
持 多 个 聊天 室 的 蓝图 , 不 幸 的 是 ， 现 在 还 不 能 很 好 地 实现 那个 设计 。 在 那个 设计 中 ,一 个 给 定 的 
用 户 可 以 订阅 多 个 聊天 室 , 而 且 聊 天 应 用 程序 可 以 追踪 到 不 同 的 用 户 分 别 订阅 了 哪些 内 容 。 但 是 
目前 , 我 们 的 聊天 应 用 程序 没有 任何 方法 能 跟踪 到 是 谁 发 出 了 特定 的 请 求 , 因此 我 们 也 不 知道 显 
示 给 用 户 的 是 哪个 聊天 室 。 

登录 和 认证 不 仅 是 聊天 系统 这 样 的 应 用 程序 需要 ， 可 能 在 每 个 App Engine 应 用 程序 开发 中 都 

像 登录 这 样 的 功能 无 处 不 在 , 而 且 是 非常 必要 的 , 几乎 会 出 现在 每 个 应 用 程序 中 , App Engine 
提供 了 所 谓 “ 服 务 ” 的 API。 服 务 就 是 由 App Engine 实 现 所 提供 的 模块 ， 无 论 开发 者 使 用 什么 样 
的 框架 构建 应 用 程序 ， 其 App Engine 应 用 都 可 以 使 用 该 模块 。 即 使 开发 者 决定 在 应 用 中 使 用 
Django， 也 仍然 可 以 使 用 所 有 的 App Engine 服 务 。 

设置 认证 最 简单 的 方法 是 使 用 Google App Engine 的 users 服 务 , 该 服务 在 Google 账 户 上 实现 。 
如 果 开 发 者 的 应 用 使 用 Google 邮 箱 地 址 作为 主要 的 标识 符 , 那么 该 应 用 就 可 以 使 用 Google 的 登录 
服务 。 如 果 开 发 者 愿意 ,可 以 构建 自己 的 认证 服务 , 或 者 使 用 第 三 方 认证 服务 , 没有 什么 理由 强 
迫 开发 者 必须 使 用 GAE 的 登录 服务 ,但 是 GAE 的 登录 服务 非常 方便 ,而 且 对 大 多 数 应 用 程序 而 言 ， 
它 可 能 就 足够 了 。 使 用 其 他 服务 不 会 有 很 大 的 不 同一 一 基本 的 机 制 都 是 相似 的 。 
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5.2 users 服务 


Google 的 登录 由 users 服 务实 现 。users 服 务 跟踪 当前 登录 的 用 户 ， 并 提供 给 应 用 程序 登录 
和 注销 页 面 的 功能 。 


5.2.1 用 户 对 象 和 当前 用 户 


使 用 users 服 务 可 以 做 的 最 简单 的 事情 就 是 从 当前 登录 的 用 户 中 取 回 user 对 象 。 开发 者 可 以 
随时 调用 users.get_current_userG) 取 回 用 户 。 如 果 没 有 用 户 从 那个 客户 端 登 录 ， 调 用 返回 
None; 如 果 有 一 个 登录 的 用 户 ， 开 发 者 会 收 到 一 个 Python 对 象 ， 该 对 象 有 以 下 三 个 实例 方法 。 

D nickname() 与 用 户 相 关 的 文本 名 称 。 这 最 终 是 用 户 可 配置 的 ， 但 此 刻 ， 它 只 返回 电子 

邮件 地 址 中 @ 符 号 之 前 的 部 分 。 我 这 里 就 是 markcc。 

口 emai1() 用 户 的 电子 邮件 地 址 。 这 里 是 markccQgmai1.com。 

口 user_id() ”用 户 的 永久 标识 符 。 请 把 它 当 作 一 个 不 透明 的 字符 串 。 用 户 随时 可 以 修改 
他 们 的 邮件 地 址 或 者 昵称 , 但 是 他 们 的 user_id 始 终 都 是 相同 的 。 该 字符 串 并 不 用 于 显示 
目的 ， 但 是 如 果 开 发 者 想 要 记录 用 户 的 永久 信息 一 一 如 一 个 用 户 在 电子 商务 网 站 的 一 组 
订单 一 一 就 可 以 使 用 user_id 作 为 标识 符 ， 而 不 用 管 它 的 内 容 到 底 是 什么 。 
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5.2.2 用户 登 录 


我 们 需要 为 用 户 提供 一 个 登录 页 面 。 幸 运 的 是 ， 我 们 不 需要 设计 自己 的 登录 页 面 一 一 毕 竞 ， 
每 个 登录 页 面 都 大 同 小 异 。users 服 务 提 供 了 自动 生成 登录 页 面 的 机 制 。 

标准 的 users 登 录 服 务 的 目的 是 作为 一 个 桥梁 : 那 就 是 一 个 页 面 ， 用 户 沿 着 这 个 页 面 到 达 他 
们 真正 想 要 访问 的 内 容 。 在 我 们 的 聊天 应 用 程序 中 ,用 户 首先 会 看 到 一 个 欢迎 界面 ,他 们 从 这 个 
欢迎 界面 进入 聊天 室 ， 查看 正在 进行 的 会 话 。 但 是 , 我 们 想 让 用 户 在 访问 聊天 室 前 先 登 录 ， 以 使 
我 们 知道 他 们 都 是 谁 。 如 果 用 户 没 有 登录 就 想 要 进入 聊天 室 ， 则 会 被 导向 登录 页 面 。 只 要 他 们 完 
成 登录 ， 就 会 被 直接 导向 聊天 页 面 。 

考虑 到 这 一 点 ，users 服 务工 作 的 方式 就 是 处 理 用 户 登 录 ， 并 且 由 开发 者 提供 给 它 一 个 目标 
页 面 。 但 是 ， 当 用 户 成 功 登 录 后 ， 它 会 自动 将 用 户 重 定向 到 目标 页 面 。 

我 们 的 聊天 程序 就 有 具有 这 种 非常 典型 的 风格 。 我 们 可 以 在 聊天 页 面 的 RequestHandler 的 
get 方 法 中 增加 一 些 逻 辑 操作 ， 使 它 以 这 种 方式 工作 。 

在 get 的 开头 ， 我 们 调用 users.get_current_userG) 检 查 用 户 是 否 已 经 登录 。 如 果 返 回 的 
是 一 个 已 登录 的 用 户 ， 我 们 就 继续 操作 ， 显 示 页 面 ; 如 果 不 是 ， 则 创建 一 个 登录 页 面 ， 将 聊天 页 
面 本 身 作为 成 功 登录 后 的 重 定向 页 面 。 这 听 起 来 有 点 让 人 害怕 , 但 其 实 没有 听 上 去 这 么 复杂 : 多 
许 用 户 登 录 ， 并 且 如 果 他 们 成 功 登录 后 重 定向 到 聊天 页 面 的 调用 方法 是 : 

self.redirect(users.create_login_url(self.request.uri)) 


换 名 话说， 我 们 正在 执行 一 个 重 定向 ， 告 诉 App Engine 将 用 户 导 向 登录 页 面 。 登 录 页 面 通过 
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users 服 务 调用 users.create_login_ur1 生 成 。 当 用 户 成 功 登 录 后 ， 我 们 将 其 重 定向 到 聊天 页 
面 。 我 们 甚至 不 需要 记 住 聊 天 页 面 的 URL， 仅 使 用 了 原来 请 求 的 URI， 该 URI 在 请 求 处 理 程 序 
self.request.uri 中 可 以 得 到 。 


5.3 整合 users 服务 到 聊天 软件 中 


现在 我 们 知道 如 何 登 录 了 ， 可 以 将 users 和 登录 整合 到 聊天 应 用 程序 中 。 要 做 到 这 一 点 ,我 
们 需要 对 聊天 应 用 程序 做 一 系列 的 修改 : 

(1) 修改 聊天 页 面 ， 要 求 用 户 登 录 ; 

(2) 使 用 登录 的 user 对 象 设 置 聊 天 消息 的 user 字 段 ， 并 从 聊天 信息 输入 表单 中 删除 用 户 字段 ; 

(3) 修改 POST 消息 处 理 程序 以 使 用 已 登录 的 用 户 。 

我 们 已 经 在 $.2.2 节 中 , 看 到 了 如 何 完成 用 户 登 录 。 只 需 更 多 类 似 的 代码 ， 就 可 以 将 该 功能 集 
成 到 我 们 的 聊天 页 面 请 求 处 理 程 序 中 。 聊天 页 面 请 求 处 理 程序 的 另 一 个 变化 是 从 表单 中 删除 用 户 
名 称 字 段 。 更 新 的 请 求 处 理 程序 如 下 : 











login-chat/pchat.py 


class ChatRoomPage(webapp.RequestHandler): 
def get(self): 
user = Users.get current_user() 
0 if user is None: 
self.redirect(users.create_login_url(self.request.uri)) 
else: 
self.response.headers["Content-Type"] = "text/html" 
self.response.out.write(""" 
<htm1> 
<head> 
<title>MarkCC's AppEngine Chat Room</title> 
</head> 
<body> 
<hi>Welcome to MarkCC's AppEngine Chat Room</h1> 
<p>(Current time is %s)</p> 
""" % (datetime.datetime.now())) 
# 输出 聊天 信息 包 
messages = db.GqlQuery("SELECT * From ChatMessage ORDER BY timestamp") 


for msg in messages: 
self.response.out.write("<p>%s</p>" % msg) 


self.response.out.write(""”" 
<form action="/" method="post"> 
<p><b>Enter new message from: %s 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea> </div> 
<div><input type="submit" value="Send ChatMessage"/></div> 
</form> 
</body> 
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</htm]l> 
@ """ % user.nickname ()) 


登录 代码 在 1 处 ， 并 且 完 全 遵循 我 们 前 面 描述 的 模式 。 如 果 用 户 已 经 登录 ， 聊 天 应 用 程序 为 
他 们 显示 聊天 内 容 ; 如 果 他 们 没有 登录 ， 将 被 重 定向 到 登录 页 面 ， 登 录 后 再 返回 到 聊天 页 面 。 

另 一 处 更 新 在 2 处 ， 我 们 从 表单 中 删除 了 用 户 名 输入 字段 ， 用 一 个 提示 行 代替 ， 提 示 行 使 用 
从 当前 登录 用 户 对 象 中 得 到 的 昵称 。 

POST 处 理 程 序 的 修改 完全 相同 。 我 们 只 需 增 加 一 个 get_current_user 行 的 副本 ， 在 创建 
ChatMessage 的 调用 中 使 用 ， 如 下 所 示 : 























login-chat/pchat.py 


def post(self): 
if user is None: 
self.redirect(users.create_login_url(self.request.uri)) 
0 User = Users.get_current_user() 
msgtext = self.request.get("message") 
if user.nickname() is None or user.nickname() == "": 
nick = "No Nickname" 
else: 
nick = user.nickname() 
msg = ChatMessage(user=user.nickname(), message=msgtext) 
msg.put() 
sys.stderr.write("******x Just stored message: %s" % msg) 
# 已 经 将 消息 添加 到 聊天 室 ， 然 后 重 定 向 到 登录 页 面 
self.redirect('/') 


现在 , 我 们 已 经 有 提供 登录 服务 的 能 力 , 可 以 开始 将 聊天 应 用 程序 变 得 更 有 趣 了 。 我 们 可 以 
构建 很 多 功能 ， 例 如 多 聊天 室 、 订 阅 以 及 其 他 功能 ， 如 连接 某 些 用 户 、 管 理 用 户 间 私人 消息 等 。 
当然 ,天 下 没有 免费 的 午餐 ， 当 我 们 增加 这 些 功 能 时 ， 用 来 显示 用 户 界面 的 HIML 就 变 得 更 加 复 
杂 了 ， 需 要 不 断 地 生成 相同 的 HTML 代码 样板 。 这 项 工作 费力 、 容 易 出 错 而 且 令 人 厌烦 。 在 下 一 
章 , 我 们 将 学 习 如 何在 应 用 程序 中 添加 订阅 和 多 聊天 室 功能 ， 以 及 如 何 使 用 模板 生成 用 户 界面 的 
HTML， 使 HTML 没 有 错误 、 不 一 致 或 者 其 他 问题 。 
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到 目前 为 止 ， 在 我 们 写 的 所 有 代码 里 ， 一 直通 过 输出 HTML 的 Python 代码 来 显示 用 户 界面 。 
这 样 做 很 费力 、 很 笨拙 , 而 且 容 易 出 错 。 在 本 章 中 , 开发 者 将 学 习 模 板 , 用 模板 来 组 织 Google App 
Engine 应 用 程序 的 代码 , 从 而 将 显示 用 户 界 面 的 代码 与 应 用 程序 的 逻辑 实现 分 离开 来 。 使 用 模板 ， 
开发 者 可 以 直接 将 用 户 界面 作为 标记 的 HTML 表 单 进行 编写 ， 而 不 用 通过 Python 输 出 语句 来 显示 
HTML 用 户 界 面 代 码 。 应 用 程序 逻辑 仍然 使 用 Python ， 只 是 在 需要 生成 页 面 时 调用 模板 即 可 。 


6.1 模板 入 门 


回想 第 3 章 “ 第 一 个 真正 的 云 应 用 程序 ”, 我 们 勾勒 出 一 个 非常 高 级 的 聊天 系统 。 我 们 设计 的 
聊天 系统 可 以 支持 多 个 发 生 在 不 同 聊天 室 的 并 发 聊天 ， 并 且 ， 用 户 可 以 通过 订阅 不 同 的 聊天 室 ， 
同时 参与 多 个 聊天 。 

但 是 , 到 目前 为 止 , 我 们 构建 了 只 支持 一 个 聊天 室 的 应 用 程序 。 在 上 一 章 中 , 我 们 考虑 了 完 
整 的 聊天 应 用 程序 的 一 个 方面 : 识别 登录 的 用 户 。 我 们 需要 登录 功能 ， 既 能 减少 用 户 每 次 登录 时 
输入 用 户 名 的 麻烦 ， 也 可 以 追踪 到 谁 参 与 了 哪个 聊天 。 虽 然 我 们 有 跟踪 用 户 的 能 力 , 但 是 到 目前 
为 止 , 它 只 是 为 用 户 提供 了 方便 。 我 们 没有 管理 多 个 聊天 内 容 ,， 也 没有 跟踪 或 保护 用 户 的 任何 信 
息 ， 而 这 些 都 是 我 们 所 需要 的 。 

我 们 要 开始 实现 一 些 更 有 趣 的 功能 。 为 了 实现 这 些 功 能 , 将 先 介 绍 一 些 新 的 视图 。 正 如 在 前 
面 的 章节 中 看 到 的 , 添加 新 的 视图 很 痛 蔡 ,因为 编写 代码 生成 HTML 非 常 笨拙 , 而 且 也 容易 出 错 。 

为 了 使 这 些 工作 更 容易 、 更 易于 维护 ， 我 们 将 学 习 使 用 模板 ( Template ) 工具 。 模 板 为 创建 
描述 用 户 界 面 的 HTML 代 码 提 供 了 一 个 灵活 的 、 易 于 使 用 的 系统 。 它 之 所 以 灵活 、 易 于 使 用 ,本 
质 上 是 因为 它 将 系统 的 逻辑 从 外 观 中 分 离 出 来 。 逻 辑 继 续 使 用 Python 语言 编写 ， 而 外 观 ， 我 们 将 
采用 有 注释 的 HTML 模 板 文件 。 

有 很 多 模板 语言 -Google App Engine 的 webapp 框 架 包括 了 来 自 开源 Django 项 目的 模板 , 因此 ， 
Django 就 是 我 们 要 用 的 模板 。 如 果 开 发 者 喜欢 其 他 模板 ， 可 以 自行 采用 : 只 需要 把 Python 文件 放 
到 相应 的 项 目 里 ， 它 就 可 以 工作 了 。 
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6.1.1 为 什么 学 习 另 一 种 语言 


与 所 有 网 络 应 用 程序 一 样 ， 云 应 用 程序 通过 生成 浏览 器 中 可 显示 的 HTML 来 构建 用 户 界 面 。 
这 样 做 很 方便 ， 因 为 可 以 很 容易 地 动态 创建 各 种 有 吸引 力 的 界面 。 对 于 创建 用 户 界 面 来 说 ， 网 络 
浏览 器 是 一 种 非常 灵活 、 一 致 且 友好 的 平台 ,开发 者 通过 浏览 器 就 可 以 使 用 HTML 语 言 所 提供 的 
一 切 优 势 。 尤 其 是 采用 即将 出 台 的 HTML5 标 准 ， 开 发 者 可 以 创建 更 加 漂亮 的 界面 。 

问题 是 正确 地 生成 HTML 将 会 很 难 ， 而 且 很 容易 出 错 。HTML 有 一 套 非常 详细 的 语法 ， 并 
且 和 大 多 数 编程 语言 一 样 ， 使 用 某 些 相同 的 引用 字符 。 这 意味 着 开发 者 必须 注意 代码 的 编写 方 
式 一 一 但 无 论 多 么 仔细 ， 仍 然 很 容易 犯错 。 

模板 有 助 于 解决 这 个 问题 。 采 用 模板 ， 就 可 以 将 代码 分 为 两 部 分 : 计算 部 分 和 界面 部 分 。 计 
算 部 分 是 用 于 完成 工作 、 生 成 想 要 在 网 络 页 面 中 显示 的 数据 的 部 分 。 在 计算 部 分 ， 主 要 是 操作 数 
据 一 一 有 时 可 能 将 其 中 一 些 数据 通过 HTML 显 示 ， 但 是 在 大 多 数 情况 下 ， 计 算 部 分 并 不 显示 。 

界面 部 分 全 是 有 关 生 成 HTML 的 。 它 获得 计算 部 分 产生 的 数据 , 将 其 以 HTML 方式 显示 。 在 
大 多 数 应 用 程序 中 ，HTML 代 码 的 很 大 一 部 分 是 固定 的 。 在 我 们 的 聊天 应 用 程序 中 ， 每 个 页 面 
的 显示 都 必须 生成 基本 的 HTML 结 构 ， 以 及 页 面 的 头 部 、 消 息 和 人 口 表 等 等 。 只 有 消息 列表 的 内 
容 是 变化 的 ,其 他 一 切 都 是 完全 相同 的 .这 意味 着 有 大 量 的 print 语 句 并 没有 做 任何 有 用 的 工作 ， 
只 是 输出 固定 的 字符 串 以 形成 HTML 页 面 的 一 部 分 ,HTML 构 入 在 代码 中 , 这 种 租 入 方式 确实 很 
难 操作 。 

有 了 模板 之 后 ， 开 发 者 用 Python (或 者 其 他 任何 语言 ) 编写 代码 的 计算 部 分 。 如 果 开 发 者 需 
要 将 任何 HTML 显 示 为 计算 的 一 部 分 ， 那 么 ， 使 用 能 入 在 Python 中 的 HTML 字符 串 即 可 。 至 于 代 
码 的 界面 部 分 ， 可 直接 用 HTML 语 言 编写 ， 然 后 使 用 特殊 的 元 语法 能 人 所 有 需要 的 计算 ， 这 些 计 
算 将 在 HTML 文 件 中 插入 动态 内 容 。 

事实 上 ， 开 发 者 可 以 使 用 模板 编写 整个 应 用 程序 。 但 是 ， 正 如 采用 标准 的 Python 代码 显示 
HTMI 一 样 ， 尝 试 在 模板 内 部 使 用 复杂 的 编程 逻辑 也 是 很 困难 、 痛 苦 而 且 容 易 出 错 的 。 


6.1.2 ”模板 基础 : 采用 模板 显示 聊天 软件 


使 用 模板 可 以 做 的 第 一 件 事 是 将 从 数据 仓库 中 取 回 聊天 消息 的 逻辑 , 与 为 显示 聊天 内 容 而 呈 
现 的 页 面 的 逻辑 两 者 分 离开 来 。 为 实现 该 功能 ,我们 将 应 用 程序 的 聊天 页 面 编写 为 模板 ， 然 后 修 
改 Python 代码 来 使 用 该 模板 。 我 们 用 聊天 显示 页 面 编写 的 模板 的 一 个 非常 简单 的 版 本 如 下 所 示 : 
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template-chat/chat-template.html 


<htm1> 
<head> 
<title>{{ title }}</title> 
</head> 
<body> 
0 <hl>Welcome to {{ title }} </hl> 
@ <p> Current time is {% now "F j Y H:i" %}</p> 
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© {% for m in msg_list %} 
0 <p> {{ m.user }} ( {{ m.timestamp }} ): {{ m.messagelescape }} </p> 
{% endfor %} 
<form action="/talk" method="post"> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 
</form> 
</body> 
</htm1> 


Dijango 模 板 是 一 种 衣 入 了 特殊 的 非 XML 语 法 标记 的 文本 文件 。 现 在 ， 我 们 要 使 用 它 生 成 
HTML， 但 Django 模 板 并 不 局 限于 生成 HIML。 开 发 者 可 以 使 用 Django 生 成 任何 由 文本 文件 构建 
的 内 容 : CSS、XML ， 甚 至 是 Python 代码 ! 

Dijango 模 板 系统 使 用 大 括号 标识 它 的 语法 。 在 我 们 的 例子 中 , 模板 文件 的 大 部 分 内 容 都 只 是 
普通 的 XML。 大 括号 里 的 内 容 在 模板 实际 使 用 时 会 被 蔡 换 掉 。 在 第 一 个 例子 中 ,我 们 只 用 了 几 
组 Django 语 法 的 元 素 : 

@ 我 们 使 用 的 第 一 个 模板 结构 是 一 个 变量 的 引用 。 在 Django 中 ， 变 量 的 引用 采用 两 边 带 双 
括号 的 标识 符 编 写 一 一 因此 ，{{ title }} 是 对 一 个 名 为 title 的 变量 的 引用 。 当 使 用 该 
模板 时 ， 它 会 被 命名 变量 的 内 容 所 替换 。 变 量 引 用 也 可 以 使 用 点 号 标识 符 ， 点 号 后 边 的 
部 分 是 对 Python 对 象 字 段 的 引用 。 我 们 稍 后 会 看 到 一 个 这 样 的 例子 。 

@ 接 下 来 我 们 看 看 Django 如 何 调 用 一 个 标签 。Django 中 的 标签 像 普通 编程 语言 中 的 函数 调 

用 。 标 签 调 用 被 包含 在 {% 和 %} 之 间 。 调 用 中 的 第 一 个 字 是 标签 的 名 称 ， 其 余 的 是 参数 。 

在 这 个 例子 中 , 我们 要 插入 当前 时 间 。Django 提 供 了 一 个 名 称 为 now 的 标签 ， 该 标签 会 被 

当前 时 间 替 代 。Django 采 用 了 一 系列 参数 来 指定 如 何 格式 化 时 间 : 

口 F 当前 月 份 的 文本 名 称 ; 

口 j 月 的 天 数 ; 

口 Y 年 的 数值 表示 ; 

口 H 当前 的 小 时 ; 

口 i 两 位 数字 格式 表示 的 当前 分 钟 。 
开发 者 在 日 期 格式 中 还 可 以 使 用 其 他 字符 一 一 请 查看 Django 模 板 文档 的 完整 列表 。 任 何不 
在 now 格 式 字 符 串 的 字母 都 包含 在 替换 文本 中 ， 所 以 传 给 now 的 参数 中 的 空格 和 冒号 都 会 
包含 在 文本 中 。 因 此 ， 日 期 显示 为 这 种 格式 : Jul 19 2009 02:45。 

目 这 里 ， 我 们 使 用 了 一 个 for 循 环 实现 Django 标 签 。 在 Dijango 模 板 文件 中 ， 标 签 可 以 有 主体 。 
把 它 看 做 与 XML 类 似 : XML 中 ,所 有 的 标签 可 以 有 一 组 称 为 属性 ( attributes ) 的 参数 ， 属 
性 是 标签 本 身 的 一 部 分 。 更 复杂 的 标签 也 可 以 有 内 容 ( content ), 内 容 是 一 些 文本 和 HTML 
标签 的 混合 ,内容 能 入 在 复杂 标签 的 开始 和 结束 之 间 。Django 模 板 的 标签 也 是 类 似 的 : 简 
单 的 标签 占 一 行 , 并 通过 放 在 标签 内 部 的 参数 定义 所 有 内 容 ; 更 复杂 的 标签 有 内 容 ， 内 容 
是 标签 和 其 对 应 结尾 之 间 的 所 有 内 容 。 在 Django 中 ， 主 体 结束 的 标志 是 {%endTAG%}。 
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在 这 个 例子 中 ， 标 签 是 一 个 循环 。 当 该 模板 被 调用 时 ， 程 序 将 循环 处 理 指 定 列表 中 的 每 个 
值 ， 并 且 为 列表 中 的 每 个 元 素 生 成 该 标签 主体 的 一 个 副本 。 这 个 循环 遍历 聊天 室 的 消息 : 
对 每 一 条 消息 , 它 会 生成 一 个 主体 的 副本 , 该 主体 的 变量 用 聊天 室 列 表 中 的 不 同 消息 替换 。 

@ 任何 时 候 ， 当 开发 者 从 一 个 用 户 那 里 得 到 输入 ， 然 后 将 输入 插入 到 用 户 界面 视图 中 时 ， 
开发 者 需要 谨慎 一 些 ， 我 们 将 在 第 17 章 详细 讨论 这 个 问题 。 如 果 没 有 足够 小 心 ， 恶 意 
户 通过 在 他 们 的 输入 中 插入 Java 脚 本 ,使 用 开发 者 的 应 用 程序 进行 一 切 恶 意 行 为 都 是 非常 
容易 的 事情 。 要 处 理 该 问题 ， 只 需 在 Django 模 板 中 通过 escape 过 滤器 运行 用 户 输入 ， 即 
使 用 |escape。 

现在 ， 我 们 有 了 用 户 界 面 页 面 的 模板 ， 下 面 需要 在 Python 代码 中 调用 该 模板 。 使 用 该 模板 的 

ChatRoomPage 更 新 版 本 如 下 所 示 : 



































template-chat/tchat.py 


class ChatRoomPage (webapp.RequestHandler): 
def get(self): 
User = Users.get_current_user() 
if user is None: 
self.redirect(users.create_login_url(self.request.uri)) 
else: 
self.response.headers["Content-Type"] = "text/html" 
messages = db.GqlQuery("SELECT * From ChatMessage ORDER BY timestamp") 
template_values = { 
'title': "MarkCC's AppEngine Chat Room", 
'msg_l1ist': messages, 


0 path = os.path.join(os.path.dirname(__file__), 'chat-template.htm]i') 
@ page = template.render(path, template_values) 
self.response.out.write(page) 


使 用 一 个 模板 时 ， 开 发 者 需要 得 到 模板 文件 的 路 径 名 ， 人 然后 调用 template. render。 
获取 路 径 名 需要 使 用 一 点 Google App Engine 中 的 技巧 。 正 如 我 们 所 看 到 的 ,在 云 中 ,开发 者 
对 应 用 程序 环境 的 控制 能 力 比 传统 应 用 程序 的 小 。 应 用 程序 和 数据 就 在 某 个 地 方 , 但 开发 者 却 不 
知道 在 哪里 。 由 App Engine 服 务 右 来 决定 把 开发 者 的 数据 存放 在 哪里 , 而 且 在 没有 警告 的 情况 下 ， 
它 可 以 随时 移动 数据 。 因 此 ， 为 了 访问 一 个 文件 ， 开 发 者 需要 问 App Engine 询 问 包含 你 的 应 用 程 
序 文件 的 目录 被 存放 到 了 哪里 。App Engine 使 用 Python 元 变量 _file 作为 当前 模块 的 源 文件 的 
引用 。App Engine 的 Python 环 境 保存 了 文件 之 间 的 基本 目录 关系 ， 因 此 ， 如 果 数 据 文件 与 开发 者 
本 地 开发 环境 的 Python 源 代码 文件 放 在 相同 的 目录 下 ， 那 么 ， 该 文件 与 在 App Engine 服 务 器 上 的 
代码 也 会 存放 在 相同 的 目录 下 。 所以, 即使 开发 者 不 知道 App Engine 存 放 其 部 署 代码 的 目录 全 名 ， 
也 可 以 找到 数据 文件 ， 因 为 它 与 部 署 代 码 放 在 相同 的 目录 下 。 为 了 找到 模板 文件 ， 我 们 通过 
__file 元 变量 , 使 用 标准 的 Python 方 法 , 得 到 包含 我 们 的 Python 代 码 的 目录 。 和 其 他 文件 类 似 ， 
os.path.dirname( _file _) 会 告诉 我 们 目录 ， 然 后 我 们 将 其 与 模板 名 称 组 合 就 得 到 了 模板 的 
路 径 名 。 
一 旦 得 到 了 模板 文件 的 引用 , 就 可 以 调用 template.render。 传递 给 该 调用 的 第 一 个 参数 是 
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模板 ， 第 二 个 参数 是 一 个 Python 字典 。Python 字 典 中 的 键 将 成 为 在 模板 中 可 以 被 访问 的 变量 
们 在 模板 中 引用 了 title 和 msg_1ist， 而 这 些 都 是 我 们 加 到 字典 中 的 键 。 


6.2 用 模板 创建 相关 视图 


当 开 发 者 构建 一 个 像 我 们 的 聊天 系统 一 样 的 应 用 程序 时 , 通常 会 有 多 个 看 起 来 相似 但 又 不 完 
全 相同 的 视图 。 例如， 我 们 希望 有 多 个 聊天 室 ， 每 个 聊天 室 一 个 视图 。 此 外 ,除了 每 一 个 不 同 的 
聊天 视图 ,我 们 还 需要 一 个 索引 视图 来 选择 聊天 室 。 索 引 视 图 和 聊天 视图 应 该 有 类 似 的 外 观 ; 聊 
天 视图 除了 有 聊天 室 的 名 称 外 ， 其 余 应 该 是 与 索引 视图 相同 的 。 
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图 6-1 ” Google Docs 的 通用 风格 


几乎 每 一 个 好 的 网 络 应 用 程序 , 其 所 有 页 面 都 有 一 个 统一 的 外 观 和 感觉 。 一 个 好 的 网 络 应 用 
程序 不 仅仅 是 网 络 页 面 的 集合 , 它 还 是 一 个 向 用 户 提供 服务 的 有 凝聚 力 的 程序 。 组 成 网 络 应 用 程 
序 的 每 个 页 面 提供 一 部 分 功能 。 该 应 用 程序 展现 给 用 户 的 所 有 页 面 都 有 着 与 其 他 程序 不 同 的 外 
观 , 并 且 它 的 所 有 部 分 都 采用 此 外 观 ， 这 使 用 户 感觉 他 们 是 在 使 用 一 个 一 致 的 、 设 计 良 好 的 应 用 
程序 。 例 如 ， 图 6-1 中 的 Google Docs 缩 略图 。Docs 表 现 为 一 个 办 公 套 件 ， 它 启动 时 的 初始 化 视图 
看 起 来 像 Windows 的 文件 浏览 右 。 当 用 户 打开 文档 时 ， 会 打开 一 个 新 的 浏览 器 窗口 ， ， 
此 文档 上 工作 。 每 个 Docs 窗 口 的 基本 布局 相同 ， 左 上 角 都 有 Google Docs 的 标志 ， 右 上 方 有 一 组 
控制 链接 ， 然 后 是 文档 标题 和 带 有 一 系列 蓝 色 阴影 的 装饰 。 用 户 一 看 就 知道 窗口 包含 的 是 Google 
Docs 的 内 容 ， 因 为 看 起 来 像 Google Docs。 

通用 页 面 布 局 和 共享 风格 结合 起 来 ,决定 了 应 用 程序 的 外 观 和 感 党 。 风 格 由 层 受 样式 表 
( CSS ) 定义 。 基 本 结构 和 共享 的 层 受 样式 表 都 可 以 定义 为 模板 ， 然后， 各 个 页 面 可 以 修改 细节 ， 
使 用 子 模 板 来 满足 其 特殊 的 需求 ， 并 且 保 持 应 用 程序 所 有 内 容 共 享 的 主 模板 的 默认 设置 不 变 。 






























































52 第 6 章 代码 组 织 


: 分 离 用 户 界面 和 还 辑 





副本 的 问题 


我 最 近 遇 到 了 一 个 有 关 副 本 的 问题 。 我 写 博客 的 网 站 进行 了 一 次 系统 升级 。 在 升级 之 
前 ， 所 有 URL 的 基本 路 径 都 是 http://.../cgi-bin/MT/; 升级 后 ， 基 本 路 径 被 改 为 http://.../mt/。 
最 终 发 现 ， 很 多 地 方 的 基本 路 径 都 是 硬 编码 的 。 在 升级 过 程 中 ， 其 中 大 多 数 得 到 了 更 正 ， 
但 还 是 有 一 些 被 漏 护 了。 结果 ， 文 章 、 评 论 和 管理 链接 都 无 法 正常 工作 ， 需 要 进行 修正 。 


他 们 花 了 整整 两 个 星期 追查 了 所 有 副本 ， 才 使 一 切 正常 工作 。 在 这 两 个 星期 内 ， 该 网 站 对 
于 作者 和 读者 来 说 都 是 一 团 糟 。 如 果 他 们 编写 一 个 计算 URL 的 简单 函数 ,在 需要 生成 URL 
的 时 候 就 调用 该 函数 ， 那 么 他 们 只 需要 修改 代码 中 的 一 行 就 可 以 ,而且 ， 什么 问题 都 不 会 
发 生 。 

不 要 让 这 种 事 发 生 在 你 身上 : 重用 代码 ， 而 不 是 复制 代码 ! 


这 些 视 图 会 有 相同 的 特 生 














FE， 如 标题 、 导 航 栏 、 标 志 等 需要 显示 在 所 有 页 面 上 的 内 容 。 开 发 者 


也 可 以 使 用 格式 化 的 元 素 ， 如 特殊 字体 、 文 字样 式 和 配色 方案 , 使 应 用 程序 的 页 面 共 享 同一 种 外 








观 和 感觉 。 所 有 的 元 素 都 是 不 同 视图 共享 的 。 每 个 页 面 有 自己 的 特殊 内 容 ， 以 规定 页 面 的 功能 ， 
但 是 ， 所 有 页 面 的 风格 都 是 一 样 的 ， 因 为 都 来 自 相 同 的 代码 。 





有 一 个 基本 的 编程 规则 : 


在 多 处 存放 同一 事物 的 多 个 副本 不 是 一 个 好 主意 。 最 终 开发 者 总 会 


需要 改变 一 些 东西 ,这 时 ， 就 很 容易 漏 掉 某 个 副本 。 我 们 真 的 希望 能 够 将 所 有 页 面 的 通用 部 分 只 
实现 一 次 ， 然 后 在 特定 的 页 面 中 引用 它们 。 


6.2.1 ”模板 继承 





Django 模 板 最 强大 的 功能 之 一 就 是 解决 了 模板 继承 ( Template Inheritance ) 问题 。 开 发 者 可 
以 将 其 网 站 中 所 有 页 面 广泛 使 用 的 通用 结构 定义 为 主 模板 ， 然 后 将 各 个 页 面 作为 该 模板 的 变种 。 


























开发 者 甚至 可 以 创建 完整 的 模板 层次 结构 ， 这 些 层次 化 的 模板 一 层 比 一 层 更 加 特定 化 。 
我 们 来 利用 一 下 模板 的 优势 。 我 们 创建 一 个 主页 面 布局 ， 顶 部 有 标志 以 及 一 些 可 定制 部 分 。 
聊天 应 用 程序 的 主 模板 如 下 所 示 : 


multichat/master.html 


<htm]1> 
<head> 
<title>{{ title } 
</head> 


<body> 





}</title> 


{% block navbar %} 


<h3>Available 
<div id="navbar"> 
<ul> 


Chats</h3> 
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{% for c in chats %} 
<1i><a href="/enterchat?chat={{c}}">{{ c }}</a></1i> 
{% endfor %} 
</ul> 
</div> 
{% endblock %} 


<hl>Welcome to {{ title }} </hl> 
<p> Current time is {% now "F 7 Y H:i" %}</p> 


{% block pagecontent %} 


<p> This is template text. If you're seeing this in a page rendered 
by chat, something is wrong.</p> 


{% endblock %} 
</body> 

</htm1> 

主 模板 不 能 被 直接 使 用 。 如 果 直 接 使 用 ， 会 生成 一 个 包含 以 下 消息 的 网 络 页 面 :“ 这 是 模板 
文本 。 如 果 您 在 聊天 室 显 示 的 页 面 中 看 到 该 消息 ， 那 就 是 出 错 了 。” 主 模板 提供 了 一 个 构建 其 他 
模板 的 基本 格式 。 

基本 页 面 布局 和 我 们 一 直 使 用 的 页 面 布 局 大 体 相 同 。 用 户 唯 一 可 见 的 修改 是 我 在 页 面 顶 部 增 
加 了 一 个 新 标志 。 同 时 ， 我 也 在 模板 中 增加 了 b1ock 标 签 。b1ock 标 签 识 别 模板 内 容 中 可 以 被 子 
模板 替换 的 部 分 。 我 们 使 用 master.htm]1 作 为 主 聊天 应 用 程序 的 模板 。 要 得 到 聊天 应 用 程序 的 基 
本 视图 ， 并 用 新 的 主 模 板 来 构建 该 视图 ， 我 们 需要 创建 一 个 新 的 子 模板 ， 如 下 所 示 : 


















































multichat/basic.html 
OQ {% extends "master.htm]" %} 


@ {% block pagecontent %} 
<p> All chat messages as of {% now "H:i" %}</p> 


{% for m in msg_list %} 

<p> {{ m.user }}@{{ m.timestamp }}: {{ m.messagelescape }} </p> 

{% endfor %} 

{% endblock %} 
我 们 通过 extends 标 签 将 其 声明 为 子 模板 ， 该 标签 必须 在 文件 的 开头 。 然 后 在 我 们 想 要 改写 的 地 
方 放置 一 个 block 标 签 。 其 结果 会 是 一 个 包含 master.htm1 内 容 的 模板 ， 但 是 其 pagecontent 块 
会 被 我 们 之 前 使 用 的 消息 显示 循环 所 替换 。 

到 目前 为 止 ， 模 板 看 起 来 很 好 ， 因 为 它 将 HTML 代 码 与 Python 代码 分 离开 来 ， 为 我 们 提供 了 一 
种 清晰 的 编码 思路 。 我 们 能 够 分 离 用 户 界面 和 应 用 程序 逻辑 , 只 需要 设置 好 它们 之 间 传 递 的 参数 即 
可 。 但 这 只 是 我 们 看 到 的 使 用 模板 所 做 的 工作 的 一 个 表面 现象 ! 模板 继承 是 一 个 难以 想象 的 、 实 用 
的 、 强 大 的 机 制 。 我 们 在 本 书 的 后 续 部 分 会 一 直 使 用 模板 ， 并 用 其 为 应 用 程序 创建 更 好 的 界面 。 
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6.2.2 ”使 用 模板 定制 聊天 视图 


让 我 们 使 用 所 学 的 模板 知识 ， 把 聊天 应 用 程序 变 得 更 好 些 。 我 们 可 以 做 的 就 是 改进 最 近 20 
条 消息 的 视图 。 在 当前 的 版 本 中 ,发 送 消息 时 显示 的 日 期 和 时 间 的 形式 是 非常 繁琐 的 。 但 由 于 大 
多 数 时 候 我 们 是 显示 一 个 活动 的 聊天 室内 容 , 所 以 其 时 间 戳 中 的 大 部 分 文本 是 相同 的 。 这 样 显示 
不 仅 浪费 空间 ， 迫 使 消息 占用 了 更 多 的 显示 行 ,而 且 逐 渐 使 得 内 容 越 来 越 难于 阅读 。 在 理想 情况 
下 ,我 们 不 需要 包含 全 部 时 间 戳 ， 只 要 一 些 时 间 表 示 。 我 们 可 以 修改 最 近 20 条 消息 视图 的 消息 显 
示 ， 使 其 不 显示 完整 的 时 间 ， 只 标记 出 每 条 消息 从 发 送 后 经 过 的 时 间 。 

在 计算 部 分 ,我 们 需要 修改 Python 代码 ， 计 算 经 过 的 时 间 ， 并 将 这 个 时 间 加 到 我 们 传递 给 用 
户 界 面 模板 的 消息 上 : 在 用 户 界 面 代码 中 ， 我 们 需要 创建 一 个 新 的 、 修 改 后 的 showmessage 块 ， 
以 显示 消逝 的 时 间 ， 而 不 是 时 间 戳 。 

首先 , 我 们 需要 更 新 应 用 程序 的 计算 部 分 , 增加 时 间 戳 。 这 实现 起 来 很 简单 , 只 要 使 用 Python 
标准 的 timede1ta 类 就 可 以 : 

























































































multichat/tchat.py 


class ChatRoomCountedHandler (webapp.RequestHandler): 
def get(self): 
User = Users.get_current_user() 
if user is None: 
self.redirect(users.create_login_url(self.request.uri)) 
else: 
self.response.headers["Content-Type"] = "text/html" 
messages = db.GqlQuery("SELECT * From ChatMessage ORDER BY timestamp ""DESC LIMIT 20") 
msglist = messages.fetch() 
for msg in msglist: 
msg.deltatime = datetime.datetime.now() - msg.timestamp 
template_values = { 
'title': "MarkCC's AppEngine Chat Room", 
'msg_list': messages.fetch(), 
} 
path = os.path.join(os.path.dirname(__ file__), 'count.htm]i') 
page = template.render(path, template_values) 
self.response.out.write(page) 


此 代码 中 唯一 有 修改 的 地 方 就 是 在 GQL 查 询 语句 后 增加 了 循环 ， 循 环 中 给 该 消息 对 象 增加 了 
timedel1ta 字 7 段 。 这 一 小 段 代码 需要 关注 的 地 方 是 : 我 们 在 数据 仓库 对 象 中 增加 了 一 个 字段 , 但 
由 于 它 不 是 我 们 声明 的 数据 仓库 特性 , 对 存储 对 象 不 起 任何 作用 。 即 使 我 们 对 增加 了 时 间 差 的 消 
息 调用 put， 也 不 会 改变 存储 对 象 的 任何 内 容 。 

现在 我 们 已 经 更 新 了 应 用 程序 中 的 计算 部 分 ,程序 会 计算 和 存储 自 消息 发 送 后 的 时 间 , 那么， 
我 们 还 需要 通过 替换 showmessage 块 来 更 新 界面 。 可 创建 如 下 代码 实现 该 功能 : 















































6.3 多 聊天 室 55 





multichat/tchat.py 
加 {1% extends "master.htm]l" %} 


四 {% block pagecontent %} 
<p> Last 20 messages as of {% now "H:i" %}</p> 


{% for m in msg_list %} 


<p> {{ m.user }}: {{ m.messagelescape }} ({{ m.deltatime }} seconds ago)</p> 
{% endfor %} 


{% endblock %} 
QO 我 们 首先 声明 这 是 master .htm1 的 一 个 模板 扩展 ， 这 意味 着 生成 的 页 面 除 了 我 们 特意 重 
写 的 块 之 外 ， 一切 都 与 master .htm1 相 同 。 
@ 将 主页 面 中 的 pagecontent 块 重 写 ， 替 换 掉 原来 的 块 ， 从 而 呈现 出 聊天 消息 。 


6.3 多 聊天 宇 


既然 我 们 已 经 知道 如 何 使 用 模板 ,就 可 以 很 容易 地 将 各 种 不 同 的 视图 很 组 合 在 一 起 了 。 我 们 
使 用 这 些 知 识 修改 聊天 应 用 程序 , 使 其 更 加 实用 。 在 原始 的 应 用 程序 架构 中 , 我 们 希望 支持 具有 
订阅 功能 的 聊天 室 。 下 面 ， 我 们 先 开 始 提供 多 聊天 室 的 功能 ， 在 后 续 部 分 中 再 考虑 订阅 问题 。 


6.3.1 更 新 多 聊天 室 的 逻辑 


既然 我 们 想 支 持 多 聊天 室 的 功能 , 就 需要 用 一 种 方法 来 保存 可 用 的 聊天 室 列表 。 稍 后 , 我 们 会 
增加 一 个 管理 视图 ， 用 于 管理 该 聊天 室 列表 。 但 现在 , 我 们 先 用 硬 编码 来 实现 它 。 在 此 , 不 需要 考 
虑 更 新 不 一 致 的 问题 ， 因 为 它 永 远 不 会 被 更 新 ， 每 次 聊天 消息 初始 化 时 它 都 会 被 重 设 为 相同 的 值 。 

另外 , 我 们 给 聊天 消息 增加 一 些 内 容 , 以 便于 知道 它们 属于 哪 一 个 聊天 室 。 这 个 实现 很 简单 : 
只 要 在 类 中 增加 一 个 数据 仓库 的 字段 。 我 们 还 需要 修改 POST 处 理 程序 ， 让 它 设置 该 聊天 室 字段 ， 
在 设置 聊天 页 面 时 , 我 们 会 看 到 这 是 如 何 实现 的 。 修 改 后 的 ChatMessage 和 硬 编 码 的 聊天 列表 如 
下 所 示 : 



































template-chat/tchat.py 


class ChatMessage(db.Mode1) : 
user = db.StringProperty(required=True) 
timestamp = db.DateTimeProperty(auto_now_add=True) 
message = db.TextProperty(required=True) 
chat = db.StringProperty(required=True) 


CHATS = ['main', 'book', 'flame' ] 

我 们 还 需要 修改 创建 聊天 消息 的 POST 方法 ， 使 其 设置 聊天 消息 的 聊天 室 字 段 。 我 们 在 请 求 
中 增加 一 个 字段 ， 触 发 该 P0ST 方 法。 在 POST 处 理 程序 中 ， 我 们 获取 请 求 的 chat 字 段 ， 并 将 其 添 
加 到 聊天 初始 化 程序 中 。 修 改 后 的 POST 处 理 程序 如 下 所 示 : 
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template-chat/tchat.py 


class ChatRoomPoster(webapp.RequestHandler): 
def post(self): 

User = Users.get_current_user() 
msgtext = self.request.get("message") 
msg = ChatMessage(user=user.nickname(), message=msgtext, chat="chat") 
msg.put() 
# 我 们 已 经 将 信息 添加 到 聊天 室 中 ， 下 一 步 将 重 定向 到 根 页 面 
self.redirect('/') 


6.3.2 ”构建 多 聊天 室 的 登录 页 面 


当 有 人 第 一 次 访问 聊天 应 用 程序 时 ， 我 们 需要 提供 一 个 登录 页 面 一 一 一 个 通用 的 前 端 页 面 。 
对 我 们 的 应 用 程序 而 言 ， 前 端 页 面 将 所 有 聊天 室 中 最 近 的 二 十 条 消息 显示 给 用 户 。 从 该 页 面 中 ， 
用 户 可 以 看 到 哪个 聊天 室 是 活跃 的 ， 然 后 从 导航 栏 中 选择 一 个 。 用 户 不 能 从 登录 页 面 发 布 消息 ， 
因为 他 们 还 没有 选择 聊天 室 ， 我 们 也 不 知道 将 消息 发 布 到 哪个 聊天 室 。 

现在 , 我 们 将 填充 第 一 个 真正 显示 的 页 面 一 一 登录 页 面 。 我 们 不 改变 工具 栏 。 当 前 , 我们 先 
基于 之 前 的 版 本 创建 一 个 简单 的 页 面 ， 如 下 面 的 HTML 所 示 : 


























multichat/landing.html 


{% extends "master.htm]l" %} 
{% block pagecontent %} 


{% for m in msg_list %} 

<p> <b>({{ m.chat }})</b> {{ m.user }} ( {{ m.timestamp }} ): 
{{ m.messagelescape }} </p> 

{% endfor %} 


{% endblock %} 
这 正 是 在 6.1 节 使 用 的 原始 的 聊天 室 模板 中 的 主体 ， 只 增加 了 一 点 : 聊天 消息 在 行 的 开始 处 ， 用 
黑体 显示 它 所 属 的 聊天 室 。 

为 了 显示 此 信息 ,创建 了 一 个 新 的 请 求 处 理 程序 。 该 程序 和 之 前 的 请 求 处 理 程序 很 像 ， 例 如 
我 们 在 前 面 ChatRoomCounted 中 使 用 的 那个 处 理 程序 。 

然而 ， 这 个 新 的 聊天 登录 页 面 有 一 些 不 同 的 地 方 , 它 有 导航 条 : 通过 聊天 室 列表 , 用户 可 以 
从 中 选择 聊天 室 。 当 用 户 点 击 其 中 的 链接 时 ,就 会 被 导向 一 个 特定 的 聊天 室 。 接 下 来 我 们 要 做 的 
就 是 创建 那些 聊天 页 面 。 


6.3.3 ”聊天 页 面 模板 


对 于 实际 的 聊天 页 面 ,要 更 巧妙 些 。 直 到 现在 ,每 次 要 修改 任何 功能 ,都 得 创建 一 个 新 的 请 
求 处 理 程序 。 但 是 ， 所 有 的 聊天 页 面 除了 聊天 室 的 名 称 不 一 样 外 ， 其 余 都 是 相同 的 一 一 实际 上 ， 
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之 后 我 们 会 想 动 态 地 创建 和 删除 聊天 页 面 。 所 以 , 我 们 将 通过 聊天 页 面 模板 和 Python 代码 里 一 些 
巧妙 的 URL 处 理 逻 辑 的 结合 ， 对 所 有 的 聊天 只 实现 一 个 处 理 程序 类 。Python 代 码 会 通过 请 求 的 
URL 识 别 出 请 求 的 是 哪个 聊天 室 。 

基本 的 聊天 模板 和 我 们 一 直 使 用 的 老式 的 消息 显示 循环 相同 , 但 是 这 次 , 我 们 将 聊天 室 的 名 
称 放 在 页 面 头 部 ,并 从 每 条 消息 中 删除 一 一 毕竟 ,所 有 消息 都 属于 同一 个 聊天 室 , 没有 理由 需要 
重复 保留 这 些 信息 。 如 下 是 该 模板 的 实现 : 























multichat/multichat.html 
{% extends "master.htmi" %} 
{% block pagecontent %} 


{% for m in msg_list %} 

<p> <b>({{ m.chat }})</b> {{ m.user }} ( {{ m.timestamp }} ): 
{{ m.messagelescape }} </p> 

{% endfor %} 


<form action="/talk?chat={{ chat }}" method="post"> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 

</form> 


{% endblock %} 

除了 给 页 面 底部 的 登录 表 所 生成 的 POST 请 求 增 加 了 一 个 参数 之 外 ， 其 余 的 和 我 们 之 前 做 的 
基本 相同 ， 之 后 ， 我 们 将 使 用 该 参数 来 传递 发 布 消息 的 聊天 室 的 名 称 。 

该 代码 体现 了 一 些 巧妙 之 处 。 我 们 必须 处 理 两 件 事情 : 需要 验证 请 求 ， 而 且 ， 需 要 基于 请 求 
中 使 用 的 URL 来 定制 输出 。 
验证 步 又 是 新 的 。 直 到 现在 ,我 们 一 直 都 依赖 于 Google App Engine 来 处 理 验证 ,将 每 个 特定 
的 URL 映 射 到 一 个 特定 的 请 求 处 理 程序 上 ， 从 而 非法 请 求 会 产生 错误 。 但 是 现在 , 我 们 要 将 多 个 
请 求 映 射 到 一 个 单一 的 处 理 程序 上 :每 个 查看 聊天 室 的 请 求 都 会 被 相同 的 RequestHandler 人 处理 。 
因为 我 们 最 终 会 实现 增加 和 删除 聊天 室 的 功能 ， 所 以 , 没有 固定 的 聊天 室 列 表 , 能 被 我 们 用 来 进 
行 app.yam1 文 件 中 或 者 WSGIApp1ication 实 例 中 的 硬 编码 。 当 我 们 收 到 查看 特定 聊天 室 的 请 求 ， 
或 者 在 特定 聊天 室 发 布 消 息 的 请 求 时 ， 需 要 检查 请 求 中 的 聊天 室 是 否 有 效 。 
































multichat/tchat.py 


class GenericChatPage (webapp.RequestHandler): 
def get(self): 
requested_chat = self.request.get("chat", default_value=None) 
if requested chat == None or requested_chat not in CHATS: 
template_params = { 

'title': "Error! Requested chat not found!", 
'chatname': requested_chat， 
'chats': CHATS 
} 


Q@ 
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error_template = os.path.join(os.path.dirname(__file__), 'error.htm]') 
page = template.render(error_template, template_params) 
self.response.out.write(page) 
else: 
目 messages = db.GqlQuery("SELECT * from ChatMessage WHERE chat = :1 " 
"ORDER BY timestamp", requested_ chat) 
template_params = { 
'title': "MarkCC's AppEngine Chat Room", 
'msg_list': messages, 
'chat': requested_chat, 
'chats': CHATS 
} 
path = os.path.join(os.path.dirname(__ file__), "multichat.htm]') 
page = template.render(path, template_params) 
self.response.out.write(page) 


@@ 我 们 通过 解析 URL 得 到 用 户 请 求 的 聊天 室 名 称 。 新 的 URL 格 式 包含 三 部 分 ， 主 机 名 称 、 
资源 标识 符 以 及 查询 。 查 询 由 一 组 名 称 / 值 的 二 元 组 组 成 。 在 我 们 的 例子 中 ， 查 询 的 二 元 
组 如 下 : 名 为 chat 的 查询 参数 和 请 求 的 聊天 室 名 称 。 因 此 ， 例 如 ， 要 查看 聊天 室 Random， 
URL 会 是 http://markcc-chatroom-one.appspot.com/enterchat?chat=Random。 检 查 HTTP 请 求 
的 元 素 是 Google App Engine 程 序 中 一 项 常见 的 工作 ， 因 此 webapp 提 供 了 一 组 扩展 的 方法 
库 ， 用 于 检查 和 管理 URL。 要 从 请 求 的 URL 中 得 到 查询 参数 ， 只 需 使 用 get 方 法 ， 该 方法 
可 以 得 到 查询 参数 的 名 称 ， 以 及 如 果 查 询 没 有 包含 该 参数 时 所 返回 的 可 选 的 默认 值 。 
@ 正如 之 前 讨论 的 ， 我 们 需要 检查 用 户 输入 以 确保 URL 所 请 求 的 聊天 室 是 有 效 的 。 我 们 通 
过 将 其 与 全 局 已 知 的 聊天 室 列 表 进 行 对 照 来 实现 这 一 功能 。 如 果 请 求 的 聊天 室 不 存在 ， 
将 显示 一 个 错误 页 面 。 它 由 一 个 主 模板 派生 出 来 的 子 模板 生成 ， 因 此 ， 该 页 面 看 起 来 像 
是 我 们 应 用 程序 生成 的 错误 ， 而 不 是 典型 的 “页 面 无 法 找到 ”错误 。 
@@ 如 果 聊 天 室 已 经 存在 ， 我 们 就 按照 一 直 使 用 的 方法 来 显示 该 聊天 室 。 和 之 前 的 处 理 方式 
唯一 不 同 的 是 ， 在 查询 中 ， 我 们 只 选择 chat 字 段 和 用 户 选 择 的 聊天 室 匹 配 的 信息 。 
我 们 已 经 有 一 个 显示 消息 和 一 个 发 布 消息 的 通用 处 理 程序 。 还 有 什么 没 实现 呢 ?” 我 们 还 需要 
更 新 发 布 消息 的 处 理 程序 ， 以 从 消息 中 获得 聊天 记录 。 这 很 容易 : 只 需要 在 POST 人 处 理 程 序 中 增 
加 一 行 chat = self.request.get("chat")， 然后 在 ChatMessage 的 构造 函数 的 调用 参数 中 增 
加 chat=chat。 
还 剩 最 后 一 部 分 ,虽然 已 经 有 了 所 有 请 求 的 请 求 处 理 程序 , 以 及 需要 显示 的 所 有 页 面 的 模板 ， 
我 们 还 需要 修改 应 用 程序 代码 , 将 收 到 的 请 求 映射 到 适当 的 请 求 处 理 程序 上 。 要 实现 该 功能 ， 只 
需要 修改 应 用 程序 的 WSGIApp1ication 记 录 。 现 在 WSGIApp1ication 记 录 需 要 登录 页 面 、 通 用 
聊天 页 面 以 及 发 布 页 面 的 全 部 信息 。 更 新 过 的 代码 如 下 所 示 : 























































































































multichat/tchat.py 


chatapp = webapp.WSGIApplication([('/', ChatRoomLandingPage), 
('/talk', ChatRoomPoster), 
('/enterchat', GenericChatPage)]) 
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在 本 章 中 , 我 们 向 聊天 应 用 程序 的 功能 化 方面 迈进 了 一 大 步 。 我 们 使 用 模板 将 程序 逻辑 与 用 
户 界面 分 隔 开 ， 而 且 开 始 使 用 通用 页 面 结构 ,定义 和 使 用 了 主 模版 和 模板 扩展 ， 从 而 为 应 用 程序 
的 所 有 页 面 提供 了 一 个 共同 的 外 观 。 

不 幸 的 是 ,尽管 增加 了 这 些 功能 , 但 是 我 们 的 应 用 程序 仍然 很 简陋 。 实际 上 , 它 看 上 去 并 不 
像 一 个 应 用 程序 ， 而 更 像 一 堆 网 页 。 页 面 布局 踢 松平 淡 。 在 下 一 章 中 ,我 们 将 了 解 层 登 样式 表 ， 
使 用 它 我 们 可 以 描述 : 在 页 面 中 如 何 定义 和 布局 出 一 个 真正 漂亮 的 应 用 程序 ,以 及 如 何 使 用 模板 
和 层 县 样式 表 将 聊天 应 用 程序 从 一 个 简陋 但 功能 齐全 的 系统 转变 成 一 个 更 完美 的 系统 。 
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口 Django 模 板 语言 : 面向 模板 作者 ，http://docs.djangoproject.com/en/dev/topics/templates/。 
官方 的 Django 模 板 文档 。 
口 Google App Engine 模 板 文档 ，http://code.google.com/appengine/docs/python/gettingstarted/ 
templates.html。 
该 Google 文 档 描述 了 如 何在 App Engine 应 用 程序 中 使 用 Django 模 板 。 
口 Django 电子 书 2.0，http://www.djangobook.com/en/2.0/。 
一 本 关于 完整 的 Django 架 构 的 在 线 电 子 书 ， 包 括 了 模板 语言 的 详细 演示 。 


























增强 用 尸 界 面 的 美观 性 : 
模板 和 CSS 


























在 上 一 章 中 , 我 们 做 了 很 多 事情 ， 以 填补 应 用 所 缺少 的 功能 。 但 是 ,坦率 地 讲 ， 我 们 的 应 用 
程序 仍然 有 些 简陋 (或 至 少 也 是 平淡 无 奇 的 ): 








'. . 
Welcome to MarkCC's AppEngine Chat Room 
(Current time is 2009-07-02 01:43:13.554471) 
MarkCC (2C09-07-02 01:42:49.129927): Hello, is there anybody out there? 
Prag (2009-07-02 01:42:56.823207): Yup, Im here. 


MarkCC (2C09-07-02 01:43:13.468926): Good. i'm working on chapter 3, and testing the cnat code. 


Name: 


Message 


Send ChatMessage 











事实 上 , 它 看 上 去 比 一 个 普通 的 网 页 要 糟糕 得 多 ， 因为， 如 今 几 乎 每 一 个 网 页 都 多 少 会 用 上 
些 样式 。 我 们 需要 做 些 工 作 ， 使 其 看 起 来 好 一 点 ， 不 再 像 一 个 网 页 ， 而 是 像 一 个 应 用 程序 。 

在 这 一 章 中 , 我们 要 将 我 们 的 应 用 程序 组 装 起 来 ， 结 合 使 用 模板 和 CSS 来 给 应 用 程序 设 定格 
式 和 样式 。 





7.1 CSS 简介 


我 们 需要 立足 于 设计 网 络 浏览 器 的 人 们 的 工作 之 上 。 我 们 要 使 程序 看 起 来 更 好 , 却 又 没有 一 
项 内 容 是 App Engine 所 特有 的 ， 甚 至 都 不 是 云 编程 所 特有 的 。 我 们 将 要 使 用 的 是 标准 的 、 基 于 
HTML 的 格式 化 技术 。 在 云 应 用 程序 中 ,最 大 的 不 同 就 是 : 我 们 使 用 它们 显示 应 用 程序 的 用 户 界 
面 ， 而 不 仅仅 是 呈现 一 个 漂亮 的 网 页 。 技 术 是 相同 的 ， 目 标 却 是 不 同 的 。 但 是 ， 它 也 有 难以 使 用 
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的 一 面 ， 因 为 HTML 和 CSS 原 本 不 是 为 构建 用 户 界 面 而 设计 的 。 我 们 将 要 依赖 的 功能 实际 上 也 是 
从 早期 云 应 用 程序 构建 者 那里 借鉴 来 的 , 虽然 这 些 技 术 能 够 用 来 完成 工作 , 但 是 需要 一 些 时 间 来 
适应 。 

要 理解 该 技术 ， 开 发 者 需要 了 解 它 的 起 源 。 在 网 络 初 期 ， 人 们 习惯 于 调整 HTML， 从 而 尝试 
生成 用 户 界面 。 通过 创建 精心 设计 的 、 骸 套 在 框架 中 的 般 套 表 的 结构 化 文档 ,开发 者 可 以 创建 出 
看 起 来 还 不 错 的 页 面 一 一 前 提 是 用 户 在 正确 的 操作 系统 上 使 用 了 正确 的 浏览 器 版 本 , 以 及 合适 的 
屏幕 大 小 。 但 是 所 生成 的 HTML 的 复杂 性 难以 想象 ， 而 且 非 常 难以 维护 ， 甚 至 不 能 在 不 同 的 浏览 
器 之 间 移 植 。 

这 样 的 策略 显然 是 不 可 管理 的 。 把 页 面 的 内 容 和 其 应 该 显示 的 方式 两 者 混在 一 起 ， 只 会 使 事 
情 变 得 一 团 糟 。 因 此 , 我 们 需要 采用 一 种 方式 将 页 面 的 外 观 与 页 面 的 内 容 相 分 离 ， 其 解决 方案 就 
是 采用 被 称 为 CSS 的 技术 。 

CSS 使 得 网 络 开发 者 将 结构 与 外 观 分 离开 来 。HTML 用 来 描述 页 面 的 结构 一 一 开发 者 基于 页 
面 的 结构 元 素来 标记 页 面 :章节 、 上 段落 和 列表 。CSS 则 完全 是 关于 外 观 的 , 它 提供 了 一 种 获取 HTML 
文档 结构 元 素 ， 以 及 描述 这 些 元 素 应 该 如 何 显示 的 方式 。 

CSS 将 样式 与 结构 分 离 。 其 背后 的 思想 与 我 们 在 之 前 的 章节 中 将 用 户 界面 和 应 用 程序 的 逻辑 
分 离 基 本 类 似 ，CSS 可 将 文档 的 结构 与 其 外 观 分 离 。 结 构 用 HTML 编 写 ， 外 观 用 CSS 描 述 。 这 样 
的 分 离 方式 有 以 下 三 个 优点 。 

口 关注 点 分 离 (Separation of Concerns ) 

关注 点 分 离 是 通用 软件 工程 原则 的 一 个 特有 术语 : 将 不 同 的 思想 融合 在 一 段 代码 中 总 会 
使 事情 变 得 复杂 。 正 如 前 文 所 述 , 试图 将 HTMIL 文档 的 结构 与 其 显示 方式 组 合 在 一 起 ,就 
导致 了 不 可 移植 的 、 难 以 维护 的 混乱 局 面 。 我 们 将 会 不 断 提 到 关注 点 分 离 这 一 原则 ， 比 
如 上 一 章 中 将 应 用 程序 的 逻辑 与 页 面 显 示 分 离 ， 本 章 中 将 结构 从 外 观 分离 ， 以 及 下 一 章 
中 将 基本 的 用 户 界面 显示 与 数据 显示 分 离 。 

口 可 重用 性 (Reusability ) 
样式 通常 不 是 针对 一 个 单一 网 络 页 面 的 。 网 站 上 的 所 有 页 面 ， 或 者 组 成 应 用 程序 的 所 有 
视图 ， 通 常 都 采用 同样 的 样式 。 将 样式 信息 分 离 出 来 ， 可 以 使 开发 者 仅 编写 一 次 样式 ， 
然后 就 可 以 在 所 有 的 页 面 中 重复 使 用 ， 而 不 是 一 遍 又 一 遍地 产生 相同 样板 的 样式 信息 。 
每 个 新 页 面 只 需要 包含 一 行 声 明 ， 用 来 指定 描述 其 样式 的 CSS 文 档 即 可 。 

口 灵活 性 (Flexibility) 
用 户 可 能 想 要 更 改 页面 样 式 的 属性 。 例 如 ， 有 视觉 障碍 的 用 户 可 能 想 切 换 到 更 大 的 、 更 
易于 阅读 的 字体 ， 或 增加 不 同 元 素 之 间 的 色彩 对 比 度 。 如 果 样 式 表 独立 于 文档 存放 ， 用 
户 就 更 容易 通知 他 们 的 浏览 器 使 用 自己 特定 的 样式 进行 蔡 换 。 


7.2 使 用 CSS 为 文本 添加 样式 
CSS 基 于 一 个 非常 简单 的 想法 : 开发 者 声明 一 个 结构 元 素 ， 称 为 选择 器 (Selector )， 然 后 针 
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对 选择 器 ， 再 声明 一 系列 特性 / 值 的 二 元 组 。 例 如 ， 我 们 想 使 聊天 室 的 背景 变 为 蓝 色 ， 并 在 标题 
文字 下 加 下 划 线 ， 就 可 以 使 用 下 面 的 CSS : 


css-chat/snippets.css 


body { 

background-color: #8888FF; 
} 
hi { 

text-decoration: underline; 
} 


此 代码 包括 两 个 CSS 语 句 。 由 于 是 第 一 次 使 用 选择 器 body， 所 以 它 会 应 用 于 整个 HTML 文 件 的 全 
部 内 容 。 在 样式 内 部 ， 它 声明 了 一 个 特性 (background-color )， 并 使 用 一 个 表示 中 等 蓝 色 的 
十 六 进 制 RGB 码 定义 该 颜色 值 。 

第 二 条 语句 则 更 为 具体 。 它 的 选择 右 是 nl1， 所 以 它 仅 应 用 于 最 上 层 的 标题 。 它 指定 text- 
decoration 特 性 ， 用 来 美化 文字 ， 为 文本 添加 阴影 、 下 划 线 和 删除 线 等 。 这 条 语句 声明 一 级 标 
题 应 该 加 下 划 线 。 

要 将 此 样式 应 用 于 我 们 的 聊天 页 面 ， 需 要 将 其 保存 在 一 个 文件 中 ,然后 在 HTML 页 面 模板 中 
添加 一 个 片段 ， 告 诉 用 户 的 浏览 器 获取 该 CSS 文 件 ， 并 用 它 来 显示 页 面 。 如 果 我 们 把 CSS 放 在 一 
个 名 为 chat-style.css 的 文件 中 ， 就 可 以 在 HTML 文 档 的 头 部 增加 一 个 样式 表 链 接 ， 将 此 样式 
应 用 于 该 页 面 ， 如 下 所 示 : 














css-chat/snippets.html 


<head> 
<title>{{ title }}</title> 
<link rel="stylesheet" media="screen" 
type=" text/css" href="chat-style.css"/> 
</head> 


利用 这 些 基 本 知识 ,我 们 使 用 样式 来 构建 一 个 新 的 聊天 室 版 本 。 在 此 过 程 中 , 我 们 将 看 到 如 
何 用 更 灵活 的 方式 使 用 CSS 选 择 器 。 

先 从 简单 的 开始 : 把 整个 页 面 的 背景 改 为 深蓝 色 ; 欢迎 的 标题 信息 用 一 个 大 的 、 有 吸引 力 的 
字体 ， 并 将 文字 设 为 白色 ,背景 设置 为 深蓝 色 : 




















css-chat/snippets.css 


hi { 
font-family: 16px Helvetica, sans-serif; 
color: #FFFFFF; 
background-color: #0000A0; 

} 


这 一 步 中 唯一 的 新 内 容 是 如 何 声 明 字 体 。 字 体 有 点 复杂 , 因为 不 同 操作 系统 上 的 不 同 浏览 器 可 用 
的 字体 集 是 不 同 的 。 我 们 并 不 只 指定 一 种 字体 ， 而 是 按照 优先 顺序 指定 一 系列 字体 。 如 果 第 一 个 
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字体 在 显示 该 页 面 的 浏览 器 上 是 可 用 的 ， 浏览 器 就 会 使 用 该 字体 ;如果 不 是 ， 它 会 尝试 下 一 个 ， 
依 此 类 推 。 如 果 我 们 的 样式 文件 中 列 出 的 所 有 字体 在 浏览 器 中 都 不 可 用 ,浏览 器 将 使 用 默认 字体 。 
代码 实现 的 工作 是 ， 字 体 应 该 以 16 像 素 的 大 小 显示 ， 并 且 字 体 优先 选择 Helvetica; 如 果 Helvetica 
不 可 用 ,那么 浏览 器 会 使 用 其 默认 的 sans-serif 字 体 。 

我 们 还 为 <body> 元 素 和 <h1l> 元 素 声明 了 background-color 特 性 。 这 是 层 琶 的 一 个 极其 简单 
的 使 用 。 样 式 ， 无 论 是 来 自 多 个 样式 表 ， 还 是 来 自 样式 表 内 的 多 条 语句 ， 当 有 多 个 声明 时 ， 内 容 
如 何 解析 都 遵循 一 组 规则 。 完 整 的 规则 相当 复杂 ， 但 基本 的 思路 是 这 样 的 : 最 特定 的 CSS 声 明 总 
是 被 优先 考虑 。HTML 文 件 中 的 CSS 优 先 于 链接 样式 表 ; 特定 页 面 的 链接 样式 表 优 先 于 网 站 的 默 
认 样 式 表 ; 岗 套 元 素 的 样式 特性 组 优先 于 包含 该 元 素 的 相同 的 样式 特性 组 。 因 此 ， hl 元素 的 背景 
将 优先 于 body 元 素 的 背景 。 

接 下 来 更 新 导航 条 。 导 航 条 会 存在 于 许多 网 页 上 ， 所 以 我 们 不 希望 它 占 用 太 多 的 空间 , 但 希 
望 它 很 明显 。 我 们 将 其 设 为 小 的 黑色 文字 、 白 色 背 景 。 要 做 到 这 一 点 ， 需 要 对 HTML 和 CSS 都 进 
行 修改 。 对 于 HTML， 只 需 对 导航 条 块 进行 如 下 更 改 : 



































css-chat/snippets.css 


{% block navbar %} 

<p id="navbar"> 

{% for c in chats %} 

<a href="{{ c.url }}">c.name</a> 
{% endfor %} 

</p> 

{% endblock %} 


我 们 修改 了 导航 条 , 使 它 成 为 一 个 聊天 室 名 称 的 水 平 栏 , 我 们 还 将 其 封装 在 有 注解 的 <p> 标 签 内 。 
该 标签 中 包含 了 id= 属 性 。ID 是 HTML 中 为 使 用 CSS 而 专门 添加 的 一 种 机 制 。 有 了 ID ， 我 们 就 能 
够 编写 一 个 影响 HTML 文 档 中 特定 元 素 的 CSS 规 则 。 由 于 导航 条 是 唯一 的 〈 我 们 知道 聊天 室 永远 
只 会 有 一 个 导航 条 )， 因 而 可 以 用 一 个 标识 符 来 标识 它 。 然 后 ， 我 们 就 可 以 使 用 选择 器 #navbar 
来 给 导航 条 设 定 样式 。 ID 附加 到 什么 元 素 上 并 不 重要 , 它 可 以 是 HTML 文 件 中 的 任意 元 素 。 因此 ， 
我 们 可 以 修改 导航 条 ， 不 管 是 图 片 ， 还 是 <div> 标 签 ， 或 者 是 <span> 标 签 ， 抑 或 是 一 个 列表 ， 都 
可 以 一 一 而 且 根 本 不 需要 修改 CSS。 下 面 是 样式 化 导航 条 的 CSS: 















































css-chat/chat.css 


#navbar { 
font-family: 8px Helvetica, sans-serif; 
color: #000000; 
background-color: FFFFFF; 

} 


这 里 的 CSS 非 常 简单 。 我 们 使 用 名 称 为 #navbar 的 ID 选 择 器 ， 然 后 声明 相应 的 特性 。 
现在 ， 我 们 再 来 看 看 聊天 室 中 实际 聊天 时 的 界面 。 在 聊天 过 程 中 ， 每 个 消息 使 用 <p> 标 签 表 
示 段 的 显示 。 我 们 希望 其 中 一 些 <p> 标 签 用 来 显示 来 自 其 他 用 户 的 消息 ， 另 外 一 些 用 来 显示 查看 
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该 网 页 的 用 户 的 消息 ， 并 且 ， 我 们 希望 页 面 上 所 有 的 消息 段 都 与 其 他 段落 显示 的 不 同 。 

HTML 又 一 次 派 上 用 场 了 。 有 一 种 标记 页 面 上 标签 的 方法 ， 使 我 们 能 够 声明 一 个 应 该 以 特殊 
方式 显示 的 特殊 XML 标签 的 某 些 实例 。 用 户 可 以 用 class= 属 性 来 注解 任意 HTML 标签 ， 然 后 用 
户 可 以 编写 选择 器 , 将 其 应 用 于 声明 了 特定 class= 值 的 任意 标签 , 或 者 应 用 于 某 一 特定 标签 ( 如 
<p> )。 在 这 个 聊天 应 用 程序 中 ， 我 们 先 做 一 个 特定 的 选择 器 。CSS 样 式 可 以 为 无 标记 的 <p> 标 签 
声明 一 个 样式 ， 对 有 标记 的 标签 声明 一 个 特定 的 样式 。 根 据 通常 CSS 的 “最 特殊 规则 ”， 特 殊 标 
签 的 样式 会 覆盖 通用 标签 的 样式 。 因 此 , 我 们 为 两 种 聊天 消息 编写 两 种 样式 。 对 于 浏览 页 面 的 用 
户 所 发 送 的 消息 , 我 们 用 纯 白 色 文 本 ; 对 于 其 他 人 所 发 送 的 消息 , 我 们 将 绘制 一 个 暗 黄色 的 背景 。 
实现 该 功能 的 CSS 如 下 所 示 : 





















































css-chat/chat.css 


p.sentbyme { 
color: #FFFFFF; 
font-family: 9px Helvetica, sans-serif; 


} 


p.sentbyother { 
color: #DDDDFF; 
font-family: 10px Helvetica, sans-serif; 
background-color: #000080; 

} 


正如 你 所 看 到 的 ， 属 性 class= 设 置 为 sentbyme 的 <p> 标 签 的 选择 需 被 改写 为 p.sentbyme。 

要 使 用 此 CSS， 需 要 修改 HTML 页 面 模板 或 Python 应 用 程序 逻辑 ， 以 使 查看 页 面 的 用 户 所 发 
送 的 消息 和 其 他 用 户 所 发 送 的 消息 有 不 同 的 分 类 。 请 思考 一 下 什么 被 改变 了 , 然后 , 我 们 再 来 决 
定 修改 哪里 。 这 里 是 应 用 程序 逻辑 的 改变 ， 还 是 仅仅 是 应 用 程序 外 观 的 变化 ? 

在 这 个 例子 中 ， 只 是 外 观 进行 了 改变 ， 因 此 通过 模板 来 实现 这 一 功能 。 我 们 将 使 用 模板 
的 扩展 来 显示 聊天 页 面 ， 该 扩展 包括 一 个 条 件 测试 ， 以 决定 每 条 消息 使 用 哪个 类 。 模 板 如 下 
所 示 : 











































































































css-chat/distinct-messages.html 
{% extends master.html %} 
{% block pagecontent %} 
{% for m in msg_list %} 


0 {% ifequal msg.sender m.user %} 
<p class="sentbyme"> 
{% else %} 
<p class="sentbyother"> 
{% endifequal %} 


<b>({{ m.chat }})</b> {{ m.user }} ( {{ m.timestamp }} ): 
{{ m.message | escape }} </p> 
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{% endfor %} 


<form action="/talk&chat={{ chat }}" method="post"> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 

</form> 


{% endblock %} 
在 @ 处 ,我们 使 用 一 个 新 的 Django 模 板 代 码 。ifequal1 标 签 需要 两 个 变量 ， 根 据 Python 检 查 它 们 
是 否 相 等 。 如果 相等 , 它 输出 ifequa1 和 e1se 之 间 的 HTML 文 本 ; 否则 , 它 会 输出 else 和 ifequall 
块 结尾 之 间 的 文本 ,因此 ,这 段 代码 用 来 检查 消息 的 发 送 者 与 查看 该 网 页 的 用 户 的 名 称 是 否 相 同 。 
如 果 两 者 是 相同 的 ， 它 将 生成 一 个 声明 为 sentbyme 类 的 <p> 标 签 ; 否则 ， 它 会 生成 一 个 声明 为 
sentbyother 类 的 <p> 标 签 。 

在 CSS 中 经 常 可 以 省 略 标签 的 名 称 。 我 们 可 以 声明 一 个 样式 规则 ,将 其 应 用 于 具有 特定 类 的 
任意 标签 。 如 果 在 上 面 的 样式 规则 中 省 略 p， 那 么 ， 选 择 器 将 只 是 .sentbyme 和 .sentbyother， 
这 些 规 则 就 可 以 应 用 于 具有 该 类 的 所 有 标签 。 这 是 一 个 非常 有 用 的 技术 ,原因 如 下 所 述 。 

(1) 有 一 些 特性 可 能 会 用 在 文档 的 很 多 地 方 。 例 如 ， 对 于 页 面 中 描述 错误 的 部 分 ， 我 们 通常 
希望 能 用 鲜红 色 来 显示 这 些 部 分 。 因 此 可 以 创建 一 个 error 类 。 然 后 在 输出 中 任何 有 错误 文字 的 
地 方 一 一 无 论 它 是 一 个 头 、 一 个 段落 还 是 小 部 分 的 黑体 文本 ， 我 们 都 可 以 给 其 标签 添加 
Class="error"。 

(2) 可 以 为 应 用 程序 尝试 不 同 的 布局 。 例 如 ， 导 航 栏 开始 时 是 项 目 符号 列表 ， 之 后 把 它 改 成 
横向 列表 。 我 们 可 以 使 用 一 个 类 设置 用 户 界 面 元 素 的 装饰 特性 〈 如 颜色 和 字体 风格 )， 然 后 当 改 
变 在 HTML 中 编写 界面 元 素 的 方式 时 ， 就 不 需要 修改 CSS 了 。 
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我 们 已 经 明白 了 CSS 是 如 何 通 过 控制 字体 、 颜 色 和 装饰 使 界面 看 起 来 更 具有 视觉 吸引 力 的 。 
但 对 于 构建 用 户 界面 而 言 , 仍然 缺 了 一 些 非常 重要 的 内 容 一 布局。 为 了 使 用 户 界面 既 具 吸引 力 
又 实用 , 需要 控制 内 容 在 屏幕 上 呈现 的 位 置 。 将 用 户 界 面 布局 交 给 用 户 浏览 器 的 布局 引 警 来 处 理 
不 是 一 个 明智 的 选择 。 浏 览 器 显示 简单 的 HTML， 以 使 网 页 更 易于 阅读 ,但 难以 自动 生成 精美 的 
用 户 界 面 。 

我 们 的 用 户 界面 由 一 组 区 域 组 成 。 我 们 希望 它 的 模型 看 起 来 如 图 7-1 所 示 。 用 户 界面 有 一 个 
欢迎 的 标题 信息 ,这 是 一 个 全 屏幕 宽 的 区 域 ; 一 个 垂直 运行 于 屏幕 左 侧 的 导航 栏 ; 一 个 显示 聊天 
记录 的 区 域 ; 以 及 在 聊天 记录 下 边 的 输入 表单 。 这 些 元 素 中 的 每 一 个 都 基本 上 是 一 个 矩形 区 域 ， 
我 们 希望 它们 以 一 种 特定 的 方式 分 布 。 
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标题 栏 / 欢 迎 信息 


MarkCC (10:46) : hello,is there anybody there? 
Prag (10:47) : Yup, Iin here. 


Prag (10:47) : So how’s the book coming/ 聊天 记录 区 域 


User Jim has entered. 


MarkCC (10:48) : It coming along wellIm Writing about the chat 


application 


输入 表单 区 域 























图 7-1 ”聊天 用 户 界面 的 结构 











我 们 必须 定义 这 些 区 域 是 什么 ， 以 及 它们 应 该 如 何 布 局 。 从 我 们 到 目前 为 止 所 做 的 工作 中 ， 
读者 大 概 可 以 猜 出 来 下 面 要 讲 的 内 容 : 有 一 个 用 于 描述 各 区 域 里 是 什么 (结构 ) 的 HTML 元 素 ， 





以 及 描述 其 如 何 布局 的 CSS 特 性 〈 外观) 


7.3.1 用 div 元 素描 述 文档 结构 





HTML 语 言 的 <div> 元 素 可 以 包含 任意 其 他 HTML 标 签 和 元 素 的 集合 ， 包 括 其 他 <div>。 其 唯 
一 日 的 就 是 描述 由 其 他 元 素 集 合 所 组 成 的 结构 。 如 果 没 有 CSS 改 变 布 局 和 外 观 ， 用 户 甚 至 无 法 看 





到 <div> 在 文档 中 的 什么 地 方 一 一 默认 情况 下 ， 它 们 没有 可 见 的 特性 。 
然后 用 户 可 以 通过 CSS 选 择 器 引用 该 区 域 。 
让 我 们 更 新 一 下 基本 页 面 模板 ,使 用 <div> 元 素来 描述 文档 结构 : 














css-chat/master.html 


<htm1> 
<head> 
<title>{{ title }}</title> 
<link rel="stylesheet" media="screen" 
type=" text/css" 
href="chat-style-layout.css"/> 
</head> 


<body> 


<div id="header-block"> 

<hl>Welcome to {{ title }} </h1> 

<p> Current time is {% now "F 7 Y H:i" %}</p> 
</div> 


<div id="navbar-block"> 
{% block navbar %} 
<div id="navbar"> 
<ul> 
{% for c in chats %} 





它们 只 是 生成 一 个 区 域 ， 
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<1li><a href="{{ c.url }}">c.name</a></1i> {% end for %} 


</ul> 
</div> 
{% endblock %} 
</div> 


<div id="content"> 
{% block pagecontent %} 


<p> This is template text. If you're seeing this in a page rendered 
by chat, something is wrong.</p> 


{% endblock %} 
</body> 
</div> 


<div id="entry-form"> 
{% block entry %} 
{% endblock %} 
</div> 


</htm1> 





这 只 是 上 一 章 的 主 模板 ， 然 后 采用 了 图 7-1 中 用 户 界 面 框架 的 每 个 区 域 ， 将 用 户 界 面 对 应 部 分 的 





HTML 用 <div> 元 素 围 起 来 ， 并 用 id= 
7.3.2 ”基于 流 的 布局 





属性 对 其 进行 标记 。 


我 们 有 了 应 用 程序 视图 的 HTML 文 件 ， 视 图 被 结构 化 为 一 组 区 域 。 现 在 需要 编写 CSS 对 页 面 
进行 布局 。CSS 提 供 了 大 量 的 特性 ， 我们 可 以 采用 这 些 特性 来 管理 页 面 布局 的 方式 ,使 它 看 起 来 





像 一 个 自然 的 用 户 界面 。 














需要 注意 ( 总 有 要 注意 的 ， 不 是 吗 ? )， 布 局 非常 复杂 。 这 道理 再 自然 不 过 : 我 们 可 能 要 在 
任意 大 小 的 显示 器 及 浏览 器 窗口 内 进行 布局 , 并 且 还 要 考虑 到 在 不 同 的 浏览 器 中 布局 引擎 还 有 所 


差异 。 








我 们 使 用 流 约 束 ( Flow Constraints ) 来 描述 布局 。 其 基本 思路 是 ， 如 果 没 有 CSS 的 布局 特性 ， 





























浏览 器 通过 向 页 面 流入 文本 ， 来 实现 对 HTML 页 面 元 素 的 布局 。HTML 页 面 以 代表 空白 行 的 矩形 
开头 。 文 本 流入 该 行 ,直到 该 行 被 十 满 。 一 旦 该 行 被 填 满 ， 就 会 在 它 下 边 创建 一 个 新 行 ， 文 本 也 


























随 之 流入 新 的 区 域 。 因 此 可 以 通过 将 文本 流向 屏幕 上 各 个 矩形 区 域 , 来 完成 页 面 布局 : 从 左 到 右 ， 











然后 从 上 到 下 。 要 改变 布局 ， 就 得 进入 这 个 过 程 。 例 如 可 以 将 一 个 区 域 放 在 屏幕 特定 的 位 置 ， 从 
而 中 断 文 本 流入 过 程 ， 于 是 其 余 的 页 面 内 容 就 会 围绕 这 个 区 域 填充 。 
这 种 在 屏幕 上 布局 的 方法 将 基于 流 来 实现 。HTML 不 能 只 是 一 组 按照 任意 原 有 顺序 组 织 的 






































<div> 集 合 , 我 们 将 通过 布局 在 屏幕 上 放置 这 些 <div> 元 素 一 一 各 元 素 出 现 的 顺序 会 对 它们 具体 的 
显示 位 置 以 及 用 户 界 面 最 终 呈 现 方式 有 很 大 的 影响 。 
CSS 为 我 们 提供 了 两 个 很 棒 的 工具 用 于 构建 布局 : 浮动 框 (float ) 和 清除 (clear )。 
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动 框 
行 定 
不 使 
天 视 


CSS- 


1. 浮动 框 

浮动 框 是 一 个 CSS 样 式 包括 了 float 属 性 的 <div> 元 素 (或 其 他 HTML 元 素 )。 在 布局 中 ， 浮 
( 正如 它 的 名 字 一 样 ) 在 页 面 的 边 之 间 浮 动 。 它 们 工作 的 方式 很 简单 : 按照 标准 的 流 布局 进 
位 ， 但 是 它 并 不 停留 在 它 到 达 的 地 方 ， 而 是 浮动 到 边 上 ， 其 他 元 素 就 可 以 围绕 它 流动 了 。 
这 么 说 还 不 清楚 ， 所以, 我们 来 看 一 个 例子 。 让 我 们 组 装 一 个 聊天 用 户 界面 的 小 模型 ， 看 看 
用 浮动 框 是 什么 样子 的 ,然后 增加 浮动 框 , 看 看 它 如何 变 化 。 我们 将 做 一 个 导航 侧 边 栏 和 聊 
图 区 域 的 模型 。 下 面 是 HTML: 
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chat/flow-mockup.html 


<htm1> 
<head> 
<title>Flow UI Mockup</title> 
<link rel="stylesheet" media="screen”" 
type="text/css" href="flow-mockup.css"/> 
</head> 


<body> 
<div id="sidebar"> 
<ul> 
<1i>Chatter</1i> 
<1i>Work</1i> 
<1i>Play</1i> 
<1i>Planning</1i> 
<1i>Family</1i> 
</ul> 
</div> 


<div id="body"> 
<p>"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do 
eiusmod tempor incididunt ut labore et dolore magna aliqua. </p> 
<p> Ut enim ad minim veniam, quis nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea commodo consequat. </p> 
<p> Duis aute irure dolor in reprehenderit in voluptate 
velit esse cillum dolore eu fugiat nulla pariatur. </p> 
<p> Excepteur sint occaecat cupidatat non proident, sunt 
in culpa qui officia deserunt mollit anim id est laborum.</p> 
</div> 
</body> 
</htm1> 


它 会 生成 一 个 页 面 ， 看 起 来 像 这 样 : 
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"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor 
incididunt ut labore et dolore magna aliqua, 


Utenim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip 
ex ea commodo consequat. 


Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat 
nulla pariatur. 


Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt 
mollit anim id est laborum. 














@ Find: (Q ) (Next | Previous ) (QO Highlightall ) 加 Match dd 





我 们 可 以 使 用 CSS 让 侧 边 栏 浮动 起 来 : 


css-chat/flow-twocol.css 


#sidebar { 
float: left; 
border: 2px solid #0000FF; 
padding: 5px; 
margin-right: 5px; 


@Q@e 


} 

@@ float 的 特性 可 以 设置 为 left ( 左 )、right ( 右 ), 或 者 none ( 没有 )。1eft 在 我 们 的 例 
子 中 表示 该 元 素 应 问 左 浮动 ，right 表 示 该 元 素 应 向 右 浮动 ，none 可 以 使 开发 者 取消 继 
承 了 该 类 float 特 性 的 元 素 的 浮动 。 

@ border 特 性 使 开发 者 在 该 <div> 的 边缘 绘制 一 个 边框 。 它 的 格式 为 “宽度 style 颜色 ”。 
sty1e 描 述 了 边界 轮廓 应 该 是 什么 样子 , 可 以 是 so1id ( 实 线 )、dotted (点 线 )、 dashed 
(虚线 )、double ( 双 线 )、grooved (上 辐 的 )、ridge ( 山 的 )、inset (内 栅 ) 或 outset 
(外 镶 )。 在 这 个 例子 中 ， 我 们 使 用 简单 的 实 线 轮廓 。 

目 只 需 增加 少量 的 工作 就 可 以 使 界面 变 得 更 美观 。CSS 人 允许 开发 者 使 用 <div> 元 素 周 围 的 两 
种 空间 : 边 距 和 填充 。 边 距 是 <div> 区 域 之 外 增加 的 空间 ， 填 充 是 区 域内 增加 的 空间 。 
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使 用 该 样式 的 结果 如 下 : 








"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do 
eiusmod tempor incididunt ut labore et dolore magna aliqua. 


Ut enim ad minim veniam, quis nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea commodo consequat. 

Duis aute irure dolor in reprehenderit in voluptate velit esse 
cillum dolore eu fugiat nulla pariatur. 





Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt 
mollit anim id est laborum. 











2. 清除 

正如 上 述 截 图 所 示 ,， 主体 块 的 文本 在 侧 栏 周围 流动 。 它 紧邻 侧 栏 显示 , 一 直到 侧 栏 结 束 的 地 
方 ， 然 后 再 流动 到 左边 界 。 

我 们 也 可 以 通过 将 聊天 记录 文本 放 在 浮动 框 里 , 来 阻止 聊天 记录 文本 围绕 侧 栏 流动 。 如 果 我 
们 只 天 真 地 设置 float: right;， 得 到 的 界面 将 看 起 来 像 这 样 : 








"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do 
eiusmod tempor incididunt ut labore et dolore magna aliqua. 


Utenim ad minim veniam, quis nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea commodo consequat. 





Duis aute irure dolor in reprehenderit in voluptate velit esse 
cillum dolore eu fugiat nulla pariatur. 


Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt 
mollit anim id est laborum. 
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在 默认 情况 下 ,浮动 框 是 独立 的 ， 而 对 它们 进行 定位 时 ,每 个 浮动 框 都 认为 它 自己 是 整个 页 
面 的 宽度 。 由 于 聊天 记录 是 向 右 浮动 的 浮动 框 , 而 导航 条 是 一 个 站 左 浮动 的 浮动 框 ， 在 流动 布局 
里 , 它们 都 被 认为 是 全 页 面 宽度 的 浮动 框 , 不 会 并 排出 现 ， 在 布局 里 会 垂直 堆 苹 。 为 了 让 它们 的 
位 置 合 适 ， 我 们 需要 做 的 是 指定 它们 的 宽度 。 由 于 是 在 网 络 浏览 器 内 部 进行 操作 ,页 面 宽度 是 可 
变 的 一 一 所 以 , 通常 使 用 百分比 描述 位 置 和 宽度 。 我们 可 以 使 用 绝对 测量 值 , 但 多 数 情 况 下 最 好 
使 用 相对 值 。 为 了 按照 期 望 方式 在 模型 中 放置 这 些 元 素 , 我 们 需要 设置 宽度 。 下 面 是 更 新 后 的 样 
式 表 : 

















css-chat/flow-twocol.css 


#sidebar { 
float: left; 
border: 2px solid #0000FF; 
padding: 5px; 
margin-right: 5px; 


width: 20%; 
} 
#body { 

float: right; 

width: 70%; 
} 


p.allclear { 
clear: both; 




















} 
这 是 相应 的 页 面 : 
[DC Dinowwith-noags-andnon 
ee Flow UI Mockup 一 
(0 (© (fp CYT 
Googe 六 同 - 呈 安 -+ 昌 4 i 
0D Flow UI Mockup 


Some 

more "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed 
text, do eiusmod tempor incididunt ut labore et dolore magna 

just aliqua, 


to see 
what Ut enim ad minim veniam, quis nostrud exercitation ullamco 
will laboris nisi ut aliquip ex ea commodo consequat. 





happen in the layouts if « Duis aute irure dolor in reprehenderit in voluptate velit esse 

we added some non-float cillum dolore eu fugiat nulla pariatur. 

stuff here. I wonder if it1] 

look good or not? Excepteur sint occaecat cupidatat non proident, sunt in culpa 
qui officia deserunt mollit anim id est laborum. 
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这 样 看 起 来 还 不 错 , 但 如 果 我 们 试图 给 用 户 界面 添加 更 多 内 容 , 例如 在 底部 的 输入 框 ( 如 模 
型 所 示 )， 它 会 停止 围绕 两 个 浮动 框 流动 。 如 果 导 航 条 比 聊天 记录 更 短 ， 其 他 内 容 会 围绕 它 流动 
到 左 侧 ， 就 像 原 始 模型 中 那样 。 

我 们 需要 的 是 一 个 “不 要 围绕 它 流动 ”的 方式 。 这 就 是 清除 的 用 处 。 如 果 在 CSS 中 给 所 有 元 素 
增加 clear: both;， 就 能 看 到 我 们 想 要 的 效果 。clear: left; 清 除 左 浮动 框 ，right ;清除 右 
浮动 框 ; 或 者 both; 清 除 所 有 浮动 框 。 

给 其 余 文 本 的 <p> 标 签 增 加 一 个 allclear 类 ， 并 且 给 样式 表 增 加 p.allclear{ clear: 
both;}。 布局 结果 显示 在 这 里 ， 正 是 我 们 所 希望 的 : 











ws Chatter "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed 
ik do eiusmod tempor incididunt ut labore et dolore magna 

。 Play aliqua. 

»。 Planning 


Ut enim ad minim veniam, quis nostrud exercitation ullamco 
。 Family 9 


laboris nisi ut aliquip ex ea commodo consequat. 





Duis aute irure dolor in reprehenderit in voluptate velit esse 
cillum dolore eu fugiat nulla pariatur. 


Excepteur sint occaecat cupidatat non proident, sunt in culpa 
qui officia deserunt mollit anim id est laborum. 


Some more text, just to see what will happen in the layouts if we added some non-float 
stuff here. I wonder 这 itll look good or not? 











7.4 使 用 流 布 局 构建 我 们 的 界面 


现在 我 们 有 了 一 个 如 何 将 界面 组 合 起 来 的 基本 思路 。 只 需 再 修饰 一 下 ， 然 后 编写 CSS， 就 可 
以 使 它 成 为 我 们 想 要 的 布局 方式 。 一 旦 了 解 了 CSS 是 如 何 工作 的 ,实现 一 个 看 起 来 让 人 赞美 的 界 
面 是 很 容易 的 一 一 而 且 在 此 基础 上 得 到 那 种 很 酷 的 界面 也 并 不 难 , 只 是 需要 花 点 时 间 。 我 们 要 花 
费 一 些 时 间 来 调整 各 种 选项 、 移 动 边界 、 改 变 颜色 、 重 排 元 素 ， 等 等 。 这 些 工作 需要 时 间 ， 但 是 
是 值得 的 : 看 起 来 很 酷 的 应 用 〈 如 Gmail ) 和 看 起 来 一 般 的 应 用 ( 如 我 们 当前 的 应 用 程序 版 本 ) 
的 区 别 ， 只 是 在 修饰 CSS 上 花费 的 时 间 是 不 同 的 。 

回 到 聊天 应 用 程序 ,我 们 的 界面 有 四 个 基本 元 素 。 在 应 用 程序 的 顶部 有 一 个 欢迎 条 ; 在 其 下 
方 ， 有 一 个 左 侧 的 导航 栏 ; 在 导航 栏 旁 边 ， 有 聊天 记录 ; 这 些 内 容 的 最 下 面 ， 是 一 个 包含 新 消息 
输入 表单 的 长 方块 ， 它 占据 了 窗口 的 整个 宽度 。 下 面 是 CSS 代 码 ; 
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css-chat/app.css 


body { 
background-color: #8888FF; 
} 


#header-block { 
font-family: 16px Helvetica, sans-serif; 
color: #FFFFFF; 
background-color: #0000A0; 
border: 2px ridge #0000F0; 
} 


#navbar-block { 
float: left; 
width: 20%; 
font-family: 8px Helvetica, sans-serif; 
color: #000000; 
background-color: FFFFFF; 
border: 2px ridge #0000F0; 
padding: 4px; 
margin-right: 4px; 
} 


#transcript-block { 
padding: 4px; 
float: right; 
width: 75%; 
font-family: 8px Helvetica, sans-serif; 
background-color: 444444; 
color: #FFFFFF; 
border: 2px ridge #0000F0; 
} 


#entry-block { 
clear: both; 
border: 2px ridge #0000F0; 
margin-top: 4px; 





} 


p.sentbyme { 
color: #FFFFFF; 
font-family: 9px Helvetica, sans-serif; 


} 


p.sentbyother { 
color: #DDDDFF; 
font-family: 10px Helvetica, sans-serif; 
background-color: #000080; 

} 


显示 结果 如 图 7-2 所 示 。 一 旦 仿造 界面 看 起 来 令 我 们 满意 ， 我 们 就 可 以 在 主 模板 中 增加 一 个 
样式 表 链 接 行 ， 将 其 挂 接 到 真实 的 应 用 程序 上 ， 并 上 传 到 App Engine。 
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MarkCC's AppEngine Chatroom 











| (©@) 3%) A) ps) CTY fie:///Users/Sharec Yr ) Me» 
Googke 各 同 7 号 安 ， 口 - 伯 v 则 * 避 &.@: 
1 口 markccsAaAppengine Chatroom IF | 天 





Welcome to MarkCC's AppEngine Chatroom 


Current time is August 25 2009 8:39 


Hi. How's it going? 


Not bad. Making progress, slowly. 


Thats good. What about work? 





Work is cool, going really well. 





Send ChatMessage 








图 7-2 ”用 来 测试 CSS 的 仿造 的 聊天 界面 





这 里 没有 什么 复杂 的 东西 ， 只 是 把 前 面 讨论 的 内 容 组 合 在 一 起 。 我 们 使 用 了 颜色 、 填 充 、 边 
框 、 浮 动 框 和 清除 来 创建 想 要 的 用 户 界面 结构 。 我 们 可 以 使 用 一 个 伪造 的 文件 来 测试 一 下 这 个 
CSS 一 一 这 个 伪造 的 文件 也 是 一 个 简单 的 HTML 文 件 ， 它 所 遵循 的 结构 与 我 们 的 应 用 程序 会 生成 
的 页 面相 同 。 该 文件 包含 以 下 元 素 : 











css-chat/fake-ui.html 


<htm1> 
<head> 


<title>MarkCC's AppEngine Chatroom</title> 


<link rel="stylesheet" media="screen" type="text/css" href="app.css"/> 
</head> 


<body> 
<div id="header-block"> 


<hl>Welcome to MarkCC's AppEngine Chatroom </h1l> 


<p> Current time is March 13, 2011 8:39</p> 
</div> 


<div id="navbar-block"> 
<p><b>CHATS</b></p> 
<ul> 
<1i>Work</1i> 
<1i>Play</1i> 
<1i>write</1i> 
<1i>Misc</1i> 
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</ul> 
</div> 


<div id="transcript-block"> 
<p class="sentbyother">Hi. How's it going?</p> 
<p class="sentbyme">Not bad. Making progress, slowly.</p> 
<p class="sentbyother">That's good. What about work?</p> 
<p class="sentbyme">Work is cool, going really well.</p> 
</div> 


<div id="entry-block"> 
<form action="/talk&chat=thischat" method="post"> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 
</form> 
</div> 
</body> 
</htm1> 


7.5 在 App Engine 应 用 程序 中 包含 CSS 文件 


在 App Engine 的 Python 代码 中 使 用 CSS 有 一 些 技巧 。App Engine 对 可 执行 代码 ( 动态 内 容 ) 
和 数据 (静态 内 容 ) 是 加 以 区 别 的 。CSS 不 是 可 执行 的 , 在 App Engine 的 云 应 用 程序 的 上 下 文中 ， 
它 只 是 一 个 静态 的 数据 文件 。 因 此 ， 开 发 者 不 能 用 引用 模板 的 方式 引用 CSS。 开 发 者 的 应 用 程序 
将 生成 一 个 HTML 页 面 , 其 中 包含 一 个 引用 CSS 的 <link> 标 签 , 但 是 接 下 来 , 为 CSS 发 送 请 求 则 是 
客户 端 浏览 器 的 责任 。 

因为 这 是 一 个 单独 的 HTTP 请 求 ， 我 们 需要 告诉 App Engine 如 何 处 理 该 请 求 。 针 对 程序 处 理 
的 请 求 ， 我 们 在 app .yam1 文 件 中 写 入 ur1: 项 。 在 CSS 中 ， 我 们 要 做 的 事情 完全 相同 。 我 喜欢 把 
CSS 文 件 放 到 它们 自己 的 目录 中 ， 所 以 对 我 来 说 ， 一 个 典型 的 app .yam1 文 件 看 起 来 应 该 像 这 样 : 

































































interactive/app.yaml 


application: markcc-chatroom-one 
version: inter 
runtime: python 
api_version: 1 


handlers: 

- Url: /(.*\.css) 
static_files: static/\1 
upload: static/(.*\.css) 


- url: /(C.*\.js) 
static_files: js/\1 
upload: js/(C.*\.js) 


- Url: /.* 
script: chat.py 
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这 个 文件 有 一 个 新 条 目 , 该 条 目 处 理 所 有 以 .css 结 尾 的 请 求 。 任 何 x.css 的 请 求 都 将 被 重新 
映射 到 static/x.css 上 。 下 一 章 将 介绍 这 种 运作 方式 。 我们 只 是 在 应 用 程序 中 写 了 一 个 app.css 
的 CSS 链 接 ， 然 后 把 实际 的 CSS 文 件 放 在 static/app.css 中 。 

正如 本 童 前面 展示 的 ， 给 App Engine 应 用 程序 设 定 样式 ,使 它 看 起 来 更 美观 ， 是 一 项 艰巨 的 
任务 。 我 们 需要 与 浏览 器 布局 算法 交互 ， 使 元 素 按 照 期 望 的 方式 放置 ， 但 是 使 用 HTML 和 CSS 提 
供 的 功能 ， 已 经 可 以 达到 使 我 们 的 聊天 应 用 程序 看 起 来 不 错 的 目标 了 。 

最 近 的 几 章 一 直 贯 穿 了 关注 点 分 离 的 过 程 : 我 们 已 经 将 存储 与 应 用 程序 状态 分 离开 来 , 将 应 
用 程序 逻辑 与 显示 分 离开 来 ,现在 又 将 页 面 结 构 和 外 观 分 离开 来 。 在 下 一 章 中 , 我 们 将 继续 这 一 
过 程 ， 使 用 名 为 AJAX 的 网 络 技术 ， 将 用 户 界 面 控制 与 程序 的 其 他 方面 分 离 ， 并 且 ， 这 个 过 程 会 
让 我 们 的 应 用 程序 的 行为 看 上 去 更 像 一 个 传统 的 桌面 应 用 程序 。 用 户 将 不 再 需要 做 像 点 击 刷新 按 
钮 这 样 的 事情 去 查看 新 的 聊天 消息 一 一 我 们 的 界面 控制 层 会 自动 处 理 这 些 事 ' 


7.6 参考 文献 和 资源 


口 《CSS: 权威 指南 》，http://oreilly.com/catalog/9781565926226。 
一 本 优秀 的 书籍 ， 提 供 了 CSS 的 详细 描述 、 选 择 右 、 样 式 属性 ， 以 及 所 有 开发 者 需要 的 
其 他 内 容 。 
口 《CSS 的 艺术 和 科学 》，http://pragprog.com/titles/stp-ascss/the-art-science-of-css。 
一 本 教科 书 ， 为 如 何 使 用 CSS 生 成 赏心悦目 的 网 络 应 用 程序 提供 了 很 好 的 指南 。 
口 CSS 教 程 ，http://www.w3schools.com/css/。 
关于 各 种 CSS 样 式 和 属性 的 交互 式 测试 的 在 线 CSS 教 程 。 
口 布局 葵 苹 ，http://blog.html.it/layoutgala/。 
在 线 资源 ， 包 含 30 种 不 同 网 页 元 素 布 局 的 HTML 和 CSS 模 板 。 
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在 这 一 章 中 , 我 们 将 在 应 用 程序 的 执行 方式 上 有 一 个 巨大 的 飞跃 。 我 们 会 把 聊天 服务 变 为 交 
互 式 的 ， 而 不 是 依靠 用 户 不 断 地 点 击 “ 刷 新 ”( Refresh ) 才能 查看 新 消息 。 为 了 做 到 这 一 点 ， 我 
们 将 了 解 以 下 内 容 。 

口 JavaScript , 艇 入 在 网 络 浏览 需 中 的 编程 语言 .开发 者 可 以 在 应 用 程序 页 面 中 磐 入 JavaScript 
程序 ， 在 界面 中 创建 交互 式 元 素 。 

口 文档 对 象 模型 (DOM ), 它 将 HTML 表 示 为 一 个 可 编程 的 对 象 ， 让 开发 者 可 以 修改 使 用 网 
络 页 面 内 容 的 用 户 界面 部 分 ， 而 网 络 页 面 内 容 则 可 以 通过 JavaScript 程 序 修改 。 

口 AJAX ( 异步 JavaScript 和 XML )， 一 种 让 用 户 向 服务 器 发 送 命令 和 请 求 ， 而 无 须 重新 加 载 
页 面 的 技术 ， 使 用 户 不 需要 重新 加 载 页 面 就 能 处 理 各 种 操作 并 在 界面 中 更 新 。 

口 模型 -视图 -控制 器 (MVC : Model-View-Controller ) 范式 ， 一 种 能 将 交互 式 应 用 程序 各 组 

成 部 分 分 离开 来 的 强大 的 标准 架构 。 


8.1 交互 式 网 络 服务 : 基础 知识 


到 目前 为 止 , 我 们 的 聊天 室 完全 是 静态 的 。 我 们 在 浏览 器 中 访问 一 个 聊天 室 时 , 不管 是 发 布 
新 消息 , 还 是 在 浏览 器 中 点 击 刷 新 按钮 ， 只 能 看 到 用 户 上 次 手工 加 载 页 面 时 所 发 布 的 消息 。 这 并 
不 是 我 们 真正 期 望 的 应 用 程序 的 工作 方式 。 我 们 希望 应 用 程序 是 动态 的 , 随 着 底层 数据 的 更 新 而 
不 断 地 更 新 自己 。 在 聊天 室 中 , 我 们 希望 一 旦 有 其 他 用 户 发 布 消息 ,就 能 够 尽快 看 到 他 们 的 聊天 
内 容 ， 我 们 不 希望 必须 手动 询问 应 用 程序 是 否 有 任何 新 消息 发 布 。 

问题 是 我 们 没有 任何 使 程序 交互 的 方式 。 我 们 使 用 客户 /服务 器 的 请 求 -响应 模型 建立 了 应 用 
程序 , 事实 上 根本 没有 真正 建立 一 个 客户 端 。 我 们 实现 了 一 个 服务 器 ,并 且 使 用 了 作为 客户 端的 
网 络 浏览 絮 的 预先 打包 功能 。 在 当前 版 本 的 云 编 程 模 型 中 , 浏览 器 是 客户 端 , 而 它 的 全 部 工作 就 
是 显示 内 容 。 如 果 想 要 使 云 服 务 像 真正 的 应 用 程序 那样 工作 ， 就 需要 增加 运行 在 客户 端的 代码 。 
构建 交互 式 用 户 界面 的 关键 技术 是 AJAX， 该 技术 可 以 让 我 们 使 用 JavaScript 代 码 在 浏览 器 内 运 
行 ， 并且 提供 了 丰富 的 客户 端 功 能 。 

AJAX 是 如 何 工 作 的 呢 ?” 首 先 , 现代 的 浏览 絮 都 包括 一 个 JavaScript 解 释 器 ，JavaScript 是 一 种 
可 以 般 入 HTML 中 的 编程 语言 。 使 用 它 ， 开 发 者 就 可 以 在 响应 用 户 操 作 的 应 用 程序 页 面 中 舱 入 程 
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序 。 因 此 ， 当 用 户 点 击 按钮 时 ， 开 发 者 可 以 在 浏览 器 中 立即 处 理 该 操作 。 

其 次 , JavaScript 程 序 可 以 将 整个 HTML 页 面 或 页 面 的 任何 部 分 作为 一 个 对 象 管 理 , 称 为 DOM 
(文档 对 象 模型 ，Document Object Model ) 对 象 。 当 开发 者 更 改 页 面 的 DOM 对 象 时 ， 会 立即 更 改 
用 户 在 其 浏览 器 中 看 到 的 内 容 。 通 过 应 用 程序 页 面 的 JavaScript 和 和 DOM 对 象 ， 开 发 者 可 以 创建 立 
即 响应 用 户 操作 的 应 用 程序 。 

理论 讲 得 足够 了 , 我们 来 尝试 一 些 编程 。 我 们 还 不 准备 做 得 太 复 杂 。 在 上 一 章 中 ,为 了 区 分 
不 同 消息 , 我 们 修改 了 聊天 消息 的 显示 方式 。 现 在 要 做 的 是 添加 一 个 按钮 ,用 该 按钮 的 开关 来 实 
现 该 功能 。 当 用 户 第 一 次 加 载 应 用 程序 时 ,所 有 聊天 记录 的 消息 以 相同 的 字体 显示 。 用 户 按 下 该 
按钮 时 ， 显 示 就 会 改变 ， 使 其 他 用 户 发 送 的 消息 突出 显示 。 

我 们 要 用 CSS 类 处 理 这 个 步骤 。 于 是 在 其 他 用 户 发 送 的 消息 上 放 一 个 CSS 类 ， 以 区 别 于 查看 
该 网 页 的 用 户 所 发 送 的 消息 。 当 用 户 点 击 该 颜色 变化 按钮 时 ， 会 遍历 DOM 的 聊天 消息 ， 并 改变 
这 些 消息 的 属性 , 用 不 同 的 方式 显示 这 些 消 息 。 我 们 给 消息 赋予 三 种 不 同 的 CSS 类 : self、other 
和 other- oloreds 当 用 户 第 一 次 加 载 页 面 时 ， 所 有 的 聊天 消息 都 用 se1f 或 other 标记 。 当 用 户 
点 击 “ 突 出 显示 ”( Highlight ) 按钮 时 ， 程 序 将 扫描 所 有 消息 ， 把 所 有 other 类 的 消息 改 为 
is 要 E 够 识别 需要 改变 的 消息 ， 我 们 将 其 用 name= 属 性 标记 。 人 然后， 就 可 以 查 
找 具 有 该 属性 的 元 素 ， 修 改 它们 的 class= 属 性 ， 从 而 改变 消息 的 样式 。 

在 把 各 部 分 内 容 组 合 到 一 起 之 前 ， 我们 先 从 JavaScript 开 始 ，JavaScript 查 找 页 面 的 聊天 部 分 ， 
然后 遍历 其 结构 ,查找 有 other 类 的 <p> 标 签 。 为 了 能 够 容易 地 查找 到 对 应 的 部 分 ， 我 们 给 聊天 
记录 部 分 的 <div> 附 加 一 个 ID。 











































































































interactive/twiddle.js 


@ <script type="text/javascript"> 
function highlightMessages() { 
@ var chatBlock = document.getElementById("chat-transcript"); 
var chatMessages = doc.getElementsByName("other"); 
© for (c in chatMessages) { 
// 将 类 属性 改 为 "other-high1ight" 
for (a in c.attributes) { 


if (a.name == "class") { 
@ a.value = "other-highlight"; 
break; 
} 
} 
} 
} 
</script> 


© <input type="button" value="Highlight Others" 
id="HighlightButton" onclick="highlightMessagesQO)"/> 


@ 通过 把 JavaScript 代 码 放 在 <scrip 作 标签 内 ， 将 其 符 入 到 HTML 页 面 中 。 
@ 要 更 改 其 他 用 户 的 信息 的 样式 ， 必 须 找 到 需要 修改 的 class= 标 签 元 素 。 我 们 将 从 查找 
<div> 元 素 开 始 。 在 JavaScript 中 ， 我 们 始终 可 以 访问 正在 使 用 全 局 变量 document 显 示 的 
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文档 的 DOM 对 象 。DOM 提 供 了 很 多 查找 和 管理 页 面 元 素 的 方法 。 现 在 ， 我 们 将 使 用 
getE1ementById， 该 方法 返回 用 id= 元 素 标识 的 值 为 chat-transcript 的 DOM 对 象 ， 

目 接 下 来 ,我 们 要 查找 柑 套 在 聊天 记录 中 的 name= 属 性 的 值 为 other 的 消息 集合 ， 即 其 他 用 
户 发 送 的 消息 集合 。 同 样 地 ，DOM 提 供 了 一 种 方法 ， 正 好 实现 我 们 要 做 的 工 
作 一 一 getElementsByName， 该 方法 返回 name 属 性 包含 特定 值 的 元 素数 组 。 

@ 现在 ， 也 就 是 最 后 一 步 ， 我 们 可 以 更 新 class= 属 性 ， 突 出 显示 消息 了 。 对 于 要 更 新 的 消 
息 数组 中 的 每 个 元 素 , 我 们 需要 找到 它 的 class= 元 素 ， 然 后 更 新 该 元 素 。 要 改变 DOM 中 
的 内 容 , 只 要 直接 改变 对 象 的 特性 就 可 以 了 , 只 要 给 其 value 特 性 赋 一 个 新 的 值 就 可 以 更 
新 class= 属 性 。 

© 现在 我 们 需要 做 的 就 是 将 JavaScript 函 数 挂 接 到 用 户 界面 上 。 在 页 面 的 <fjormz> 部 分 创建 一 
个 按钮 元 素 , 在 按钮 的 onc1ick= 属 性 中 写 一 个 JavaScript 函 数 的 调用 , 将 该 函数 与 按钮 连 
接 在 一 起 。 

在 服务 器 端 ， 我 们 要 做 的 改动 非常 小 。 到 现在 为 止 ， 我 们 还 没有 将 name 属 性 应 用 到 聊天 记 

录 的 消息 中 。 要 使 用 name 属 性 ， 只 需要 对 模板 修改 一 行 代码 。 
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我 们 开始 创建 聊天 应 用 程序 时 的 代码 很 简单 : 用 几 个 Python 编写 的 消息 处 理 程序 , 生成 显示 
界面 的 HTML 代 码 。 随 着 聊天 应 用 程序 的 扩展 ， 为 使 其 更 强大 、 灵 活 且 具有 吸引 力 ， 我 们 采用 了 
新 技术 和 新 语言 ， 以 控制 程序 各 种 琐碎 功能 的 复杂 性 。 但 是 现在 ,这 些 琐碎 功能 的 数量 已 经 到 了 
让 人 感到 混乱 的 地 步 。 

当前 ， 我 们 的 应 用 程序 由 如 下 内 容 组 成 : 

口 服务 需 端 用 Python 编写 的 消息 处 理 程序 ; 
口 使 用 Django 编 写 的 HTML 页 面 模板 ; 
口 使 用 JavaScript 编 写 的 用 户 界 面 交 互 代码 ; 
口 使 用 CSS 编 写 的 用 户 界面 布局 管理 。 

到 目前 为 止 ， 因 为 代码 始终 遵循 一 个 基本 结构 ,所 以 , 所 有 这 些 都 是 可 控 的 。 在 构建 整个 程 
序 的 过 程 中 ,我们 主要 考虑 的 是 各 个 独立 HTML 页 面 的 代码 结构 。 我 们 编写 了 请 求 处 理 程 序 ， 并 
且 在 每 个 请 求 处 理 程序 中 , 生成 了 显示 在 用 户 浏 览 器 上 的 完整 的 HTML 页 面 。 这 为 我 们 的 应 用 程 
序 提 供 了 一 个 组 织 架 构 。 

但 现今 我 们 将 再 进一步 , 使 用 AJAX 使 应 用 程序 更 具 交 互 性 。 通 过 AJAX, 我 们 不 用 再 让 每 个 
页 面 完全 由 一 个 处 理 程序 生成 。 为 了 使 程序 更 易 组 织 、 可 维护 ， 必 须 考 虑 好 系统 的 架构 ， 需 要 用 
一 种 规范 的 方式 来 将 各 个 部 分 联合 起 来 ， 共 同 组 成 我 们 的 云 应 用 程序 。 

幸运 的 是 , 云 应 用 程序 非常 适合 采用 一 种 很 古老 但 十 分 强大 的 用 户 接口 设计 模式 ， 即 “模型 - 
视图 - 控制 希 ” 模 式 。 

假如 回 到 图 形 用 户 界面 发 展 的 初期 ， 你 会 兴奋 地 学 习 Smalltalk， 它 是 现代 图 形 用 户 界 面 思想 
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的 起 源 ， 窗 口 、 按 钮 、 鼠 标 和 菜单 都 来 源 于 Smalltalk。 在 Smalltalk 中 ， 程 序 员 使 用 一 种 三 部 分 设 
计 模 式 来 构建 界面 。 三 十 多 年 后 ,我 们 仍然 在 使 用 这 种 设计 模式 ， 而 且 这 种 模式 可 以 和 我 们 构建 
云 应 用 程序 用 户 界 面 的 方式 近乎 完美 地 匹配 。 图 8-1 展 示 了 一 个 MVC 应 用 程序 的 结构 。 

视图 


-显示 应 用 程序 视图 ， 











-将 用 户 的 操作 发 送 给 控制 器 ; 
-从 模型 或 控制 器 泻 染 状态 更 新 。 


了 行为 有 
a 









布局 文档 其 制 宫 
-管理 模型 与 视图 间 的 交互 ; 
一 选择 视图 ， 

-将 行为 转换 为 命令 或 请 求 ; 
-通知 视图 何 时 更 新 。 








数据 /响应 


聊天 至 请 求 /命令 
聊天 用 户 
聊天 信息 


msg:string 


-管理 程序 状态 ， 
-响应 状态 查询 ， 
-响应 命令 ， 改 变 状 态 。 














图 8-1 云 MVC 应 用 程序 架构 


在 MVC 中 ， 界面 有 以 下 3 个 组 成 部 分 。 

口 模型 (model ) 
系统 的 应 用 程序 逻辑 。 模 型 是 围绕 着 应 用 程序 计划 执行 的 数据 和 操作 的 基本 内 容 来 加 以 
实现 的 。 在 模型 中 ， 开 发 者 根本 不 用 考虑 界面 : 模型 是 完全 独立 的 ， 而 且 只 代表 底层 应 
用 数据 工作 。 对 于 云 应 用 程序 ， 模 型 就 是 服务 需 代 码 。 其 实 ， 服 务 器 并 不 与 客户 端 交互 ， 
它 需 要 等 待 客户 端 发 送 请 求 。 模 型 与 用 户 界面 完全 脱离 。 

口 视图 (view ) 
视图 是 可 见 的 用 户 界面 ， 如 显示 元 素 、 输 入 框 ， 等 等 。 在 云 应 用 程序 中 , 视图 是 用 HTML 
编写 的 ， 它 没有 自己 真正 的 行为 : 视图 只 是 一 些 显 示 元 素 ， 以 及 需要 以 吸引 人 的 方式 显 
示 这 些 元 素 的 代码 (用 HTML 和 CSS 编 写 )。 视 图 并 不 关心 应 用 程序 的 逻辑 或 数据 ， 它 只 
要 按 需 显示 内 容 即 可 。 
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口 控制 器 〈( controller ) 
控制 器 是 客户 端 和 服务 需 之 间 的 桥梁 。 迄 今 为 止 ， 我 们 忽略 了 这 一 关键 部 分 。 控 制 器 获 
取 视 图 中 产生 的 界面 操作 ， 将 这 些 操作 转换 为 模型 中 可 执行 的 操作 ; 控制 器 获取 服务 器 
生成 的 内 容 数据 ， 将 此 数据 转换 成 视图 可 以 显示 的 格式 。 在 云 中 ， 控 制 器 就 是 在 用 户 的 
浏览 圳 中 执行 的 JavaScript 代 码 。 
对 于 我 们 构建 去 应 用 程序 来 讲 ，MVC 是 一 种 很 自然 的 方式 ， 因 为 MVC 模 型 的 概念 和 我 们 构 
建 的 应 用 程序 的 各 个 部 分 能 够 很 好 地 匹配 。 我 们 要 构建 一 个 好 的 云 应 用 程序 , 需要 使 用 不 同 的 编 
程 语言 ， 这 迫使 我 们 将 应 用 程序 至 少 分 为 3 个 部 分 ， 服务 器 代码 ( 用 Python 或 Java 编 写 )、 显 示 代 
码 (用 HTML 及 CSS 编 写 )， 以 及 交互 代码 ( 用 JavaScript 编 写 )。 使 用 MVC 模 式 , 我 们 可 以 更 好 地 
理解 各 功能 与 这 三 个 部 分 间 的 对 应 关系 。 此 外 , 使 用 这 三 种 基本 部 分 设计 应 用 程序 具有 悠久 的 历 
史 ， 我 们 可 以 在 设计 云 应 用 程序 时 发 挥 其 优势 。 当 然 ， 云 计算 是 独特 的 ， 其 体系 结构 与 老式 的 
Smalltalk 用 户 界面 并 不 完全 相同 , 但 基本 思想 没 变 。 两 者 主要 的 区 别 是 , 在 云 MVC 中 , 模型 和 视 
图 直接 交互 得 比较 少 。 而 在 传统 的 MVC 中 ， 当 模型 中 的 数据 被 修改 时 ， 模 型 直接 给 视图 发 送 更 
新 。 在 云 MVC 中 ， 一 旦 视图 被 创建 了 ， 模 型 就 不 再 与 其 直接 交互 ， 而 是 需要 将 模型 的 所 有 更 新 
发 送 给 控制 器 ， 然 后 由 控制 吉 来 更 新 视图 。 
只 要 思考 一 下 就 会 发 现 ，MVC 正 是 我 们 一 直 所 做 的 云 应 用 程序 开发 过 程 中 的 下 一 步 。 由 于 
应 用 程序 变 得 更 加 复杂 了 ， 我 们 已 经 对 一 些 内 容 进行 了 解 厢 ， 也 就 是 分 离 了 各 部 分 。 我 们 将 显 
示 从 计算 中 分 离 ， 把 显示 用 模板 实现 ， 计 算 用 Python 实现 ; 我 们 将 样式 与 内 容 分 离 ， 把 内 容 放 
在 HIML 中 , 样式 放 在 CSS 中 。 现在, 我们 只 是 用 相同 的 方式 再 增加 一 个 分 离 屋 。 我们 的 客户 端 
既 有 用 户 界面 (内容 和 样式 )， 也 有 可 执行 代码 ， 要 将 其 分 到 视图 (用 HTML 和 CSS ) 和 控制 器 
(JavaScript ) 中 。 
往 下 继续 开发 聊天 应 用 程序 时 ， 要 牢记 MVC。 它 是 描述 云 应 用 程序 被 划分 为 逻辑 块 的 最 好 
的 基本 结构 。 在 本 章 中 , 我 们 已 做 的 工作 是 : 将 聊天 程序 分 为 模型 ( 服务 器 ， 有 存储 聊天 记录 的 
数据 仓库 ， 以 及 管理 与 客户 端 交 互 的 查询 处 理 程序 )、 视 图 ( 提供 基本 用 户 界面 的 HTML 和 CSS 
文档 ) 和 控制 器 (进行 所 有 交互 的 JavaScript ) 3 个 部 分 。 


8.3 与 服务 器 不 中 断 地 交互 


在 本 章 开始 ,我 们 使 用 JavaScript 在 用 户 界面 中 实现 了 动态 交互 ,而 不 需要 与 服务 器 进行 交互 。 
这 种 方法 很 有 用 , 但 其 作用 也 极为 有 限 : 我 们 只 能 让 用 户 浏览 器 中 显示 的 HTML 文档 中 的 数据 创 
建 各 项 功能 。 对 于 需要 更 多 其 他 数据 的 工作 ， 我 们 也 无 能 为 力 。 

当然 ,我 们 希望 能 够 完成 那些 依赖 从 服务 器 获取 数据 的 工作 。 虽 然 可 以 从 服务 器 获取 我 们 已 
知 的 数据 , 但 必须 在 浏览 器 的 客户 端 一 服务 器 交互 的 标准 同步 周期 内 获取 。 我 们 编写 客户 端 代码 
向 服务 器 发 送 请 求 ， 服 务 器 响应 这 些 请 求 ,并 且 当 客户 端 浏览 器 收 到 响应 时 再 将 其 显示 出 来 。 如 
果 不 做 一 些 特殊 的 工作 ， 就 不 可 能 避 开 基本 的 请 求 一 响应 一 显示 过 程 。 

这 种 请 求 一 响应 一 显示 周期 不 能 满足 云 应 用 程序 的 处 理 需求 。 我 们 想 要 编写 的 是 , 收 到 新 聊 
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天 消息 即 能 自动 更 新 显示 的 聊天 应 用 程序 ,但 聊天 应 用 程序 只 能 等 竺 用 户 手 工 刷 新 。 当 然 ,我 们 
也 可 以 编写 一 个 带 计时 器 的 JavaScript, 一 秒 自 动 刷新 一 次 。 但 每 次 发 生 刷 新 操作 时 , 会 对 用 户 造 
成 很 大 干扰 。 用 户 的 界面 会 变 为 空白 , 然后 重 绘 。 如 果 他 们 开始 输入 一 条 新 消息 ， 那么 在 浏览 器 
刷新 时 该 消息 可 能 会 丢失 ， 这 非常 粳 糕 。 

我 们 需要 做 的 是 与 服务 器 进行 异步 交互 。 也 就 是 说 , 需要 编写 一 些 代码 ， 其 运行 独立 于 通常 
的 “请 求 - 响 应 -显示 ”周期 。 这 种 技术 被 称 为 AJAX， 即 异步 JavaScript 和 XML。AJAX 使 用 一 个 
称 为 XMLHttpRequest 的 JavaScript 构 造 方法 。 坦 白地 说 ，XMLHttpRequest 很 像 一 个 整 脚 的 黑客 。 
与 我 们 开发 基于 网 络 的 云 应 用 程序 客户 端 时 所 用 的 很 多 工具 一 样 , 它 基 本 上 是 基于 一 些 人 的 特需 
要 而 揭 起 来 的 一 个 特别 的 功能 ， 而 不 是 为 构建 用 户 界面 精心 设计 的 工具 集中 的 一 部 分 。 当 人 们 开 
始 使 用 它 , 它 才 慢 慢 成 了 一 个 标准 , 而 且 现 在 我 们 非常 乐意 继续 使 用 它 。( 我 们 将 在 9.3 节 中 看 到 ， 
AJAX 可 以 被 封装 起 来 隐藏 在 幕后 ， 这 样 开 发 者 就 不 需要 处 理 这 些 简 陋 的 内 容 了 ， 但 理解 一 下 背 
后 的 真实 运作 情况 总 还 是 不 错 的 。) 

XMLHttpRequest 的 关键 在 于 ， 它 是 异步 的 ， 这 就 意味 着 发 送 一 个 请 求 时 ， 发 送 者 并 不 等 待 
响应 。 通 常 ， 我 们 编写 生成 HTTP 请 求 的 代码 时 ， 使 用 的 是 函数 调用 : 调用 一 个 方法 发 送 请 求 ， 
而 该 函数 调用 的 返回 值 是 对 查询 的 响应 。 此 时 ,代码 会 阻塞 一 它 什 么 都 不 做 ， 只 是 等 待 ， 直 到 
收 到 响应 。 但 是 XMLHttpRequest 不 会 阻塞 。 相 反 ， 当 我 们 创建 了 一 个 XMLHttpRequest， 其 参 
数 之 一 称 为 回调 函数 (callback )。 当 客户 端 浏览 器 收 到 该 请 求 的 响应 ， 会 调用 回调 函数 。 因 此 ， 
客户 端 永远 不 会 阻塞 一 它 只 是 继续 运行 ,于 是 ,用 户 看 到 的 就 是 一 个 非常 流畅 的 用 户 界面 , 没 
有 任何 中 断 或 刷新 。 一 旦 收 到 响应 ， 回 调 函 数 就 会 被 调用 ， 用 最 新 的 信息 更 新 用 户 界面 。 

这 个 描述 听 起 来 很 抽象 ,但 是 在 App Engine 中 实现 起 来 并 不 难 , 最 好 用 代码 来 说 明 这 个 问题 。 
我 们 直接 开始 编写 真正 想 实 现 的 内 容 一 一 动态 更 新 的 聊天 视图 。 

要 实现 聊天 视图 的 动态 更 新 ， 我 们 需要 编写 一 组 代码 : 

(1) 一 个 服务 器 请 求 处 理 程序 ， 该 程序 用 于 提供 没有 任何 聊天 数据 的 用 户 界面 框架 ; 

(2) 一 个 获取 聊天 数据 (新 消息 ) 的 请 求 处 理 程序 ; 

(3) 一 个 JavaScript 组 件 ， 从 服务 器 请 求 更 新 ， 然 后 在 收 到 新 数据 时 将 消息 加 入 聊天 记录 。 
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XMLHttpRequest 并 不 是 XML 的 HTTP 请 求 
XMLHttpRequest 的 命名 确实 差劲 。 实 际 上 ， 它 不 是 一 个 请 求 ， 而 且 和 XML 没有 任何 
关系 。 


XMLHttpRequest 是 请 求 的 管理 者 一 一 一 个 用 于 创建 请 求 、 发 送 请 求 ， 以 及 处 理 其 收 到 
的 响应 的 对 象 。 

XMLHttpRequest 的 最 关键 的 特点 在 于 , 它 能 够 在 通常 的 浏览 器 的 “请 求 一 响应 一 显示 ” 
周期 之 外 生成 和 发 送 请 求 ， 而 且 能 够 异步 处 理 请 求 ， 因 此 ， 开 发 者 的 程序 不 需要 等 待 响应 。 
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8.3.1 模型 : 聊天 室 的 请 求 处 理 程序 


我 们 需要 做 的 第 一 件 事 情 是 建立 一 个 服务 器 上 的 请 求 处 理 程序 。 我 们 把 请 求 处 理 程序 分 为 两 
部 分 : 向 客户 端 发 送 用 户 界 面 的 处 理 程序 和 向 客户 端 发 送 数据 的 处 理 程序 。 前 一 个 处 理 程序 向 客 





户 端 发 送 用 户 界面 , 基本 上 是 将 视 

















图 和 控制 器 发 送 到 浏览 器 , 因此 它 可 以 作为 我 们 的 应 用 程序 的 


客户 端 来 运行 。 然 后 ， 控 制 器 将 向 服务 顺 发 送 数据 请 求 ， 数 据 由 第 二 个 处 理 程序 发 送 。 
基本 的 请 求 处 理 程序 是 微不足道 的 。 我 们 将 采用 的 模板 与 一 直 在 用 的 模板 相同 ,创建 它 的 一 














个 特例 ， 产 生 一 个 空白 的 记录 区 。 
一 个 处 理 程序 ， 只 是 使 用 了 模板 。 


interactive/chat.py 


模板 将 在 后 面 的 8.3 节 中 讲述 。 该 处 理 程序 是 我 们 一 直 使 用 的 





class InterfaceServerHandler (webapp.RequestHandler): 


def get(self): 


0 requested_chat = self.request.get("chat", default_value="none") 
© if requested chat == "none" or requested_chat not in CHATS: 


template_params = { 


'title': "Error! Requested chat not found!", 
'chatname': requested_chat, 


'chats': CHATS 
} 


error_template = os.path.join(os.path.dirname(__file__), 'error.htm]i') 
page = template.render(error_template, template_params) 
self.response.out.write(page) 


else: 


messages = db.GqlQuery("SELECT * from ChatMessage WHERE chat = :1 " 


"ORDER BY timestamp", requested_chat) 


template_params = { 
'title': "MarkCC's AppEngine Chat Room", 
'msg_list': messages, 
'chat': requested_chat， 


'chats': CHATS 
} 


path = os.path.join(Cos.path.dirname(_ _file _), 'interface.htm!') 
page = template.render(path, template_params) 
self.response.out.write(page) 


对 于 数据 ， 我 们 处 理 起 来 稍 有 不 同 。 到 现在 为 止 ， 我 们 已 经 使 客户 端 操作 处 在 一 个 无 状态 


( stateless ) 的 模式 中 一 一 也 就 是 说 
是 在 交互 式 操作 中 ,客户 端 运行 时 





响应 发 送 此 时 间 之 后 发 布 的 消息 。 


， 客 户 端 从 来 不 基于 它 记 录 的 内 容 向 服务 咒 发 送 任何 消息 。 但 
， 会 不 断 地 向 服务 器 发 送 请 求 ， 而 我 们 和 希望 只 发 送 新 消息 一 一 





也 就 是 说 ， 只 发 送 上 次 客户 端 从 服务 器 获取 数据 以 后 的 消息 。 因 此 ， 请 求 中 要 包括 时 间 ， 而 且 只 





我 们 还 需要 在 发 送 给 客户 端的 响应 中 包括 时 间 。 毕 竟 , 我 们 在 云 中 : 我 们 的 客户 端 和 服务 器 
在 不 同 的 计算 机 上 ， 可 能 在 世界 的 不 同 地 区 。 各 个 计算 机 的 时 钟 设 置 可 能 不 同 ， 而 且 在 服务 器 发 
送 响应 和 客户 端 收 到 响应 之 间 会 有 一 个 时 间 延 迟 。 为 了 确保 客户 端 不 丢失 任何 消息 ,需要 知道 当 
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服务 器 在 发 送 最 后 一 条 消息 给 客户 端 时 ， 服 务 器 所 认定 的 时 间 。 

实现 所 有 这 些 功能 的 代码 非常 简单 ， 只 需要 发 送 一 个 XML 文 档 。 顶 层 元 素 是 我 们 自己 的 一 
个 <ChatUpdate> 元 素 , 其 中 包括 time= 元 素 。 在 <ChatUpdate> 内 部 , 我 们 放置 了 HTML 的 <p> 标 签 ， 
包含 聊天 消息 。 和 往常 一 样 ， 我 们 将 使 用 Django 模 板 来 生成 XML。 模 板 非常 简单 : 








interactive/update.xml 


<?xm] version="1.0" encoding="UTF-8"?> 

<ChatUpdate chat="{{ chat }}" time="{{ time }}"> 

{% for m in msg_list %} 

<p>({{ m.chat }}) {{ m.user }} ( {{ m.timestamp }} ): {{ m.messagelescape }} </p> 
{% endfor %} 

</ChatUpdate> 


模板 中 使 用 的 请 求 处 理 程序 也 非常 简单 : 


interactive/chat.py 


class DataRequestHandler (webapp.RequestHandler): 
def get(self): 
requested_chat = self.request.get("chat", default_value="none") 
messages = db.GqlQuery("SELECT * from ChatMessage WHERE chat = :1 " 
0 "ORDER BY timestamp", requested_chat) .fetch(20) 
template_params = { 
'msg_list': messages, 
'chat': requested_chat， 
'time': self.request.get("time", default_value="0"), 
} 
path = os.path.join(os.path.dirname(__file__, 'update.xm]') 
page = template.render(path, template_params) 
self.response.headers["Content-Type"] = "application/xml1" 
self.response.headers.add_header("Access-Control-Allow-Origin", "*") 
self.response.headers.add_header("Access-Control-Allow-Methods", "GET, POST, 
OPTIONS") 
self.response.out.write(page) 


这 就 是 模型 部 分 。 正 如 读者 所 看 到 的 , 模型 在 交互 模式 下 工作 ,确实 并 不 需要 太 多 特殊 内 容 。 开 
发 者 唯一 需要 做 的 是 分 离 界面 服务 过 程 和 数据 服务 过 程 。 



































8.3.2 控制 器 : 客户 端的 JavaScript 程 序 


上 一 节 的 服务 器 讨论 中 说 道 ， 会 在 初始 化 处 理 程序 中 发 送 用 户 界面 的 JavaScript 控 制 器 代码 ， 
但 在 代码 中 , 我 展示 的 所 有 内 容 就 是 一 行 包含 在 JavaScript 中 的 脚本 。 现 在 ， 要 实现 该 控制 器 。 让 
我 们 直接 进入 代码 : 





interactive/js/asynch.js 


function SetUpAndSendRequest(time, chat) { 
0 var request = new XMLHttpRequest(); 
@ var transcript = document.getElementById("chat-transcript"); 
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© request.onreadystatechange = function() { 
// 等 待 完成 请 求 。 请 求 完 成 的 标志 是 ready state 为 4. 
if (request.readyState != 4) { 
return; 
} 
@ var xmlData = request.responseXML .documentElement; 
if (xmlData != nul1) { 
transcript.innerHTML = ""; 
messages = xmlData.getElementsByTagName("p"); 
© for (var x = 0; x < messages.length; x++) { 
transcript.innerHTML += "<p>" + 
messages[x].childNodes[0] .nodeValue + "</p>"; 
3 
newtime = xmlData.getAttribute("time"); 
SetUpAndSendRequest(newtime, chat); 
} else { 
transcript.innerHTML += 
"<p>Sorry, but there was an error updating this chat</p>"; 


oy 


+ 
3 
© request.open("GET", "Jatest?time=" + time + "&chat=" + chat, true); 
request.send(); 


} 


function init() { 
SetUpAndSendRequest(0, "book") 
3 


window.onload = init; 


@ 首先 ， 我 们 设置 了 几 个 需要 使 用 的 全 局 变量 。 其 中 最 重要 的 一 个 是 XMLHttpRequest。 此 
外 ,我们 设置 了 对 主 应 用 程序 URL 的 引用 , 以 及 对 HTML 页 面 中 包含 聊天 记录 部 分 的 引用 。 

@ 从 此 开始 实际 的 请 求 代码 。 要 做 的 第 一 件 事 是 打开 一 个 请 求 。XMLHttpRequest 对 象 并 不 
是 请 求 ， 它 是 我 们 用 来 创建 和 发 送 请 求 的 对 象 。 为 了 让 其 发 送 请 求 ， 需 要 首先 打开 一 个 
新 的 请 求 ， 告 诉 它 请 求 的 参数 是 什么 。 

目 现在 我 们 进入 AJAX 异 步 部 分 的 核心 之 处 。 不 用 等 待 响 应 , 我 们 提供 了 一 个 函数 , 该 函数 
在 XMLHttpRequest 对 象 收 到 响应 时 会 被 调用 。 在 这 个 例子 中 , 我 们 把 回调 函数 写 为 内 联 
XMLHttpRequest 的 主要 回调 函数 称 为 onreadystatechange。 当 请 求 的 状态 有 任何 改变 
时 ， 函 数 就 会 被 调用 。 请 求 改 变 状 态 时 ， 可 能 处 于 各 种 不 同 的 状态 ， 如 果 能 够 响应 每 种 不 
同 的 状态 , 所 构建 的 应 用 程序 就 会 更 强大 , 但 是 , 这 超出 了 本 书 讨论 的 范围 。 有 很 多 AJAX 
方面 的 优秀 书籍 可 以 参考 一 一 如 果 开 发 者 要 做 很 多 交互 式 的 云 开 发 ,那么 确实 应 该 阅读 这 
么 一 本 书 。 本 章 结尾 的 资源 部 分 列 出 了 一 些 值得 一 读 的 优秀 书籍 。 

在 这 里 , 当 程序 收 到 完整 的 结果 时 ,会 根据 请 求 的 结果 做 出 一 些 回应 。 这 就 是 所 谓 的 ready 
state 4。 首 先 ， 我 们 需要 在 回调 函数 中 ， 确 保 是 在 状态 4。 如 果 不 是 ， 回 调 函 数 返 回 。 
该 回调 函数 会 在 下 一 次 状态 变化 时 再 次 被 调用 。 
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@ 当 回 调 函 数 最 终 在 ready state 4 下 被 调用 时 ， 我 们 知道 从 服务 器 收 到 了 最 新 的 聊天 数 
据 ， 因 此 ， 就 可 以 更 新 聊天 视图 了 。 我 们 使 用 XMLHttpRequest 的 responseXML 字 段 从 响 
应 中 抓 取 数据 。 所 有 的 聊天 消息 都 将 被 放置 到 <p> 标 签 中 ， 所 以 要 取 回 该 标签 。 

@ 追加 新 消息 ， 更 新 聊天 记录 。 

@ 至此， 用户 界 面 已 经 用 最 新 的 聊天 消息 更 新 了 。 但 是 ,我 们 需要 重新 发 起 
XMLHttpRequest, 使 得 当 更 多 的 消息 发 布 时 , 可 以 再 次 更 新 显示 。 我们 不 希望 重新 获取 
任何 已 经 显示 的 消息 ， 因 此 ， 我 们 使 用 了 响应 发 送 的 时 间 。 

@ 最 后 , 我 们 调用 此 函数 发 送 请 求 , 实际 上 , 我 们 实现 了 一 个 循环 : SetUpAndSendRequest 
通过 XMLHttpRequest 创 建 和 发 起 请 求 ， 编 写 一 个 收 到 新 数据 时 更 新 用 户 界面 的 回调 函 
数 。 回 调 函 数 会 再 次 调用 SetUpAndSendRequest。 依 此 类 推 。 

这 是 基本 的 模式 一 一 我 们 使 用 JavaScript 创 建 一 个 XMLHttpRequest， 它 发 出 请 求 ， 然 后 设置 

一 个 回调 函数 。 


























8.3.3 ”聊天 视图 


新 的 交互 式 MVC 聊 天 服务 的 视图 是 最 容易 的 部 分 。 它 只 是 一 个 模板 扩展 ， 和 我 们 之 前 已 经 
做 过 的 工作 几乎 相同 : 





interactive/interface.html 
{% extends "master.htmi" %} 
{% block script %} 
<script src="asynch.js" language="javascript"> 


@ </script> 
{% endblock %} 


{% block pagecontent %} 
加 <div id="chat-transcript"> 
</div> 


<form action="/talk?chat={{ chat }}" method="post"> 
<p><b>Message</b></p> 
<div><textarea name="message" rows="5" cols="60"></textarea></div> 
<div><input type="submit" value="Send ChatMessage"/></div> 

</form> 


{% endblock %} 
QO 我 们 的 新 模板 扩展 必须 包含 含有 控制 器 代码 的 JavaScript 源 文件 。<script> 标 记 可 以 使 用 内 
联 代码 ， 或 者 来 自 外 部 源 文 件 的 代码 。 这 里 ， 我 们 从 源 文件 中 引用 。 
@ 我 们 需要 创建 一 个 id 为 transcript 的 空 <div>，JavaScript 将 用 该 <div> 插 人 聊天 消息 。 所 
包含 的 JavaScript， 包 含 用 来 启动 交互 过 程 的 代码 ， 并 且 处 理 聊天 消息 的 显示 。 
通过 这 些 代码 ， 就 基本 完成 了 各 项 工作 。 我 们 已 经 有 了 一 个 聊天 系统 ， 其 中 ,客户 端 不 断 地 
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与 服务 器 握手 ， 以 获取 最 新 的 聊天 消息 ， 在 新 聊天 消息 发 布 时 更 新 聊天 记录 视图 。 我 们 需要 更 
新 app.yam] 文 件 名 ， 以 确保 该 文件 包含 了 所 有 的 新 模板 文件 。 我 们 还 需要 更 新 Python 应 用 程序 
对 象 ， 将 请 求 路 由 到 正确 的 处 理 程序 。 我 们 已 经 非常 接近 基本 的 聊天 软件 所 做 的 工作 : 有 了 多 
个 聊天 室 、 用 户 登 录 、 完 全 的 交互 性 ， 以 及 一 个 漂亮 的 界面 。 无 论 是 从 代码 中 分 离 数据 ， 还 是 
从 代码 中 分 离 模型 、 视 图 和 控制 器 ， 我 们 都 已 经 设立 了 一 个 坚实 的 体系 架构 ， 它 将 系统 划分 成 
了 各 个 部 分 。 

我 们 可 以 进行 一 些 更 复杂 的 工作 了 ! Google App Engine 不 限制 开发 者 必须 用 Python 编写 代 
码 ， 所 以 ,开发 者 也 可 以 使 用 其 他 语言 。 目 前 ,常见 的 男 一 种 选择 是 Java。 在 下 一 章 中 ,我们 将 
了 解 如 何 使 用 Java， 而 不 是 Python， 来 编写 我 们 的 应 用 程序 。 然 后 ， 我 们 将 进入 一 些 高 端 主题 ， 
例如 高 级 数据 仓库 、 安 全 性 和 调试 。 
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DD XMLHttpRequest, http://www.w3.org/TR/XMLHttpRequest/。 
官方 W3C 标 准 文档 ， 描 述 JavaScript 的 XMLHttpRequest。 

口 AJAX 教 程 ，http:/www.w3schools.com/Ajax/Default.Asp。 
一 个 AJAX 在 线 交 互 教程 。 
口 《Ajax: 权威 指南 》，http://oreilly.com/catalog/9780596528386。 
一 本 优秀 的 AJAX 教 科 书 。 
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我 们 一 直 在 使 用 Python 进 行 App Engine 服 务 和 应 用 程序 的 开发 。 对 于 许多 应 用 程序 来 讲 , Python 
是 一 门 很 了 不 起 的 的 语言 。 实 际 上 ， 对 于 多 数 开 发 人 员 来 说 ，Python 就 已 经 够 用 了 。 就 目前 为 止 我 
们 一 直 做 的 工作 而 言 ，Python 非 常 优秀 : 友好 , 并 且 是 轻 量 级 的 ， 正 是 这 种 轻 量 级 使 我 们 能 够 一 层 
一 层 地 构建 应 用 程序 ， 从 而 更 清楚 、 详 细 地 了 解 云 应 用 程序 内 部 各 层次 到 底 是 如 何 工 作 的 。 
说 实话 , 我 更 喜欢 在 编译 时 就 可 以 捕获 一 些 思春 的 错误 ， 而 不 是 等 到 程序 出 错时 才 在 浏览 器 
中 看 到 一 堆 错 误 信 息 。 在 给 本 书 编写 Python 代码 时 就 遇 到 了 一 个 问题 ， 有 一 次 ,我 从 请 求 处 理 程 
序 给 模板 传递 一 个 字符 串 作 为 参数 ,期望 得 到 一 个 字符 串 列 表 。 然 而 ,得 到 的 结果 却 是 浏览 器 窗 
口中 难看 的 一 大 堆 转 储 信息 。 如果 错误 可 以 提早 捕获 的 话 ,就 不 需要 在 运行 时 处 理 这 样 的 错误 了 。 
这 就 涉及 到 了 Java。App Engine 主 要 支持 两 种 编程 语言 : Python 和 Java。Python 是 轻 量 级 的 动 
态 语 言 ，Java 是 重量 级 的 。 在 App Engine 中 , 开发 者 使 用 GWT 工 具 包 构建 Java 应 用 程序 ，( 毫 不 夸 
张 地 说 ) GWT 绝 对 是 天 才 之 作 。 
即使 你 十 分 喜欢 Python， 也 有 一 些 很 充分 的 理由 使 你 想 在 云 应 用 程序 中 使 用 Java， 例 如 以 下 
这 些 。 
口 强 类 型 
强 类 型 可 以 捕获 多 种 编程 错误 。 根 据 开发 者 的 编程 风格 ， 强 类 型 可 以 在 编译 程序 时 捕获 
很 多 错误 ， 使 开发 过 程 变 得 更 容易 。 这 在 像 云 这 样 的 环境 中 是 特别 有 价值 的 ， 因 为 在 云 
环境 中 很 难 调试 程序 。 开 发 者 不 可 能 仅 使 用 一 个 调试 器 来 探查 程序 ， 也 不 可 能 只 靠 添 加 
打印 语句 就 能 找到 哪里 出 了 错 。 任 何 有 助 于 提前 发 现 问题 的 手段 ， 都 可 以 节省 开发 者 大 
量 的 时 间 。 

口 风格 
稍 后 在 本 章 可 以 看 到 ,使 用 Java 开 发 云 应 用 的 风格 和 结构 与 在 Python 中 完全 不 同 。 对 于 很 
多 开发 者 而 言 ，App Engine 中 的 Java 开 发 风格 可 能 比 Python 更 令 人 舒服。 

口 工具 
Google 发 布 了 一 套 针对 免费 Eclipse 集 成 开发 环境 的 插件 ， 用 于 构建 Java 和 GWT 的 App 
Engine 服 务 和 应 用 程序 。Eclipse 是 一 款 非常 优异 的 工具 ， 再 加 上 App Engine 插 件 ， 一切 都 
变 得 更 容易 了 。( 采用 Python 的 开发 者 也 可 以 使 用 Eclipse， 只 是 因为 没有 专门 的 App 
Engine 支 持 ， 所 以 这 样 使 用 起 来 会 相当 痛苦 。) 
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在 这 一 章 中 ， 我 们 将 了 解 如 何 使 用 GWT 开 发 云 应 用 程序 。 我 们 把 聊天 应 用 程序 移植 到 
Java/GWT 上 ,从 而 实现 本 童 的 目标 。 移 来 快速 回顾 一 下 前 面 的 内 容 , 看 看 这 次 如 何 用 Java 来 完成 
之 前 做 的 工作 。 














静态 语言 与 动态 语言 

程序 员 间 激烈 辩论 的 话题 之 一 就 是 静态 语言 与 动态 语言 训 优 就 劣 。 因 为 双方 都 有 强 有 
力 的 论点 论据 ， 所 以 ， 这 将 是 一 场 永 无 休止 的 辩论 。 两 种 语言 的 基本 区 别 在 于 检测 错误 的 
时 机 不 同 。 在 动态 语言 中 ， 错 误 只 在 代码 运行 时 才 会 捕获 。 例 如 ， 在 一 个 动态 语言 中 ( 如 
Python )， 如 果 开 发 者 编写 一 个 类 似 x.foo() 的 方法 调用 ,而 x 并 没有 一 个 “foo” 方 法 ， 
那么 要 等 到 该 语句 真正 执行 时 ， 开 发 者 才 会 得 到 一 个 错误 信息 。 

在 静态 语言 中 ， 开 发 者 需要 声明 事物 的 类 型 ， 然 后 ， 使 用 这 些 声 明 所 提供 的 信息 ， 就 
能 够 在 编译 时 捕获 到 像 上 边 例子 中 的 未 定义 方法 之 类 的 错误 。 

这 只 是 一 个 权衡 取舍 的 问题 。 在 动态 语言 中 ， 开 发 者 不 需要 写 类 型 声明 ， 也 就 不 需要 
向 编译 器 证 明 该 程序 是 正确 的 。 这 样 做 非常 方便 ， 而 且 可 以 形成 一 种 编程 风格 ， 使 用 这 种 
风格 的 代码 非常 简 尘 明了， 并且， 简单 的 代码 中 不 太 可 能 有 难以 发 现 的 错误 。 

但 是 ， 另 一 方面 ， 静 态 语言 可 以 为 开发 者 捕获 很 多 错误 。 它 促使 开发 者 采用 更 加 严格 的 
编码 方式 ， 从 而 确保 程序 可 以 通过 编译 ， 而 这 个 过 程 会 使 开发 者 养 成 良好 的 代码 设计 习惯 。 

就 个 人 而 言 ， 我 倾向 于 选择 静态 语言 。 我 发 现 ， 长 期 以 来 ， 类 型 检查 系统 所 做 的 额外 
工作 为 我 节省 了 很 多 精力 和 时 间 。 我 犯 的 大 多 数 愚 蠢 的 错误 都 能 被 编译 器 捕获 ， 从 不 会 因 
为 这 些 愚 春 的 错误 而 导致 程序 运行 时 出 现 问题 。 事 实 上 ， 我 个 人 偏好 强 类 型 语言 ， 像 函数 
型 语言 ML。ML 的 类 型 系统 有 令 人 难以 置信 的 表现 力 和 难以 想象 的 严格 性 , 比 我 们 通常 熟 
悉 的 静态 语言 (如 Java 和 C++) 要 强 很 多 。 作 为 回报 ， 我 的 ML 程序 几乎 没有 出 现 过 运行 
时 错误 。 我 的 几乎 所 有 错误 最 终 都 反映 为 类 型 的 不 一 致 ， 这 些 错误 编译 器 都 能 够 捕获 。 我 
已 经 用 ML 写 了 数 千 行 代码 规模 的 程序 ， 花 了 几 天 时 间 ， 消 除了 编译 器 的 静态 检测 类 型 错 
误 之 后 ， 这 些 程序 首次 运行 均 没 有 出 现任 何 错误 。 





9.1 GWT 简介 


使 用 Java 会 比 使 用 所 有 其 他 语言 都 优越 ， 原 因 就 是 开发 者 可 以 使 用 GWT。GWT 非 常 棒 ， 通 
过 使 用 GWT， 开 发 者 可 以 用 Java 编 写 整 个 云 应 用 程序 。 服 务 器 端 采 用 通常 的 方法 编译 Java 代 码 ， 
生成 运行 于 VM 之 上 的 Java 字 节 码 。 在 服务 器 端 ,GWT 是 一 个 不 错 的 框架 , 但 并 不 是 很 出 众 。 不 
过 别 忘 了 ， 除 了 服务 器 端 以 外 ，GWT 还 适用 于 客户 端 。 

GWT 可 以 使 开发 者 用 Java 编 写 客户 端 程序 。 用 Java 编 写 客 户 端 ， 就 像 编 写 传统 的 GUI 应 用 程 
序 一 样 : 使 用 布局 管理 器 从 部 件 集合 构建 用 户 界面 ,添加 事件 处 理 程序 ， 等 等 一 这 绝对 是 典型 
的 GUI 代码 。 但 GWT 会 将 此 GUI 代码 转换 为 HIML 和 JavaScript: GWT 并 不 是 将 Java 编 译 为 Java 字 
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节 码 ， 而 是 将 Java 编 译 为 JavaScript 源 代码 ， 然 后 在 客户 端 上 执行 。 对 客户 端 和 服务 器 端 通信 和 所 需 
要 的 所 有 AJAX 相 关内 容 ，GWT 可 以 生成 远程 过 程 调用 。 这 不 是 一 个 完全 自动 化 的 过 程 , 但 是 它 
比 手工 编写 AJAX 代 码 更 加 容易 ， 而且 代 码 健 壮 性 更 好 。( 说 实话 ， 当 我 听 到 这 个 消息 时 , 我 的 第 
一 反应 是 “他 们 疯 了 ， 真 荒 廖 !"”， 但 这 正好 也 说 明了 我 为 何 发 不 了 财 也 出 不 了 和 名。 ) 

因为 GWT 有 它 自己 的 设置 方式 ， 所 以 ， 用 GWTI 构 建 应 用 程序 与 我 们 使 用 Python 的 webapp 所 
做 的 工作 是 不 同 的 。 在 接 下 来 的 第 一 个 例子 中 , 我 们 将 会 呈现 一 个 漂亮 的 用 户 界面 ,并 且 不 需要 
深入 了 解 如 何 设置 模板 和 CSS 的 浮动 框 就 可 以 实现 这 个 漂亮 的 用 户 界 面 一 一 我 们 将 直接 切入 , 让 
GWT 做 它 最 擅长 的 工作 。 

在 很 多 方面 , 用 GWT 编 程 很 像 使 用 传统 桌面 的 GUI 框架 编程 。 开 发 者 用 几乎 与 传统 的 桌面 应 
用 相同 的 方式 定义 用 户 界 面 ， 而 GWT 负 责 生成 应 用 程序 运行 所 必需 的 绝 大 多 数 的 HTML 、CSS 和 
JavaScript。Google 近 期 的 大 多 数 应 用 程序 ( 包括 像 Wave 等 程序 ) 都 是 使 用 GWT 实 现 的 。 

为 了 初步 了 解 GWT, 首先 请 下 载 针 对 Java 的 App Engine SDK。 我 不 打算 详细 地 讲 这 方面 的 内 
容 ， 因 为 它 与 第 2 章 的 下 载 Python SDK 的 过 程 基本 相同 。 除 了 基本 框架 ， 开 发 者 还 可 以 为 Eclipse 
安装 一 组 插件 ， 提 供 一 个 优秀 的 编程 环境 。 我 强烈 建议 下 载 Eclipse 和 App Engine 搬 件 ， 能 使 用 
Eclipse 插件 进行 App Engine 开 发 ， 也 是 使 用 Java 工 作 的 极 佳 理 由 ! Eclipse 是 免费 的 ， 而 且 它 确实 
很 容易 安装 。GWT 的 一 个 缺点 是 有 很 多 元 数据 (metadata )， 这 也 就 意味 着 会 有 更 多 的 文件 用 于 
告诉 GWT 如 何 处 理 Java 源 代码 ， 比 如 哪 部 分 编译 为 客户 端的 JavaScript， 哪 部 分 设置 为 服务 器 端 
的 服务 包 ， 等 等 。 由 开发 者 维护 这 些 文件 是 很 痛苦 的 ， 然 而，Eclipse 工 具 则 为 此 提供 了 巨大 的 帮 
助 。 不 使 用 Eclipse 进 行 GWT 编 程 是 非常 不 理智 的 。 从 此 处 开始 ， 我 假设 读者 使 用 的 是 有 GWT 插 
件 的 Eclipse 开 发 环境 。 

GWT 制 定 了 一 套 与 众 不 同 的 构建 云 应 用 程序 的 方法 。 用 Python 和 webapp 开 发 时 ， 一切 都 以 
服务 器 为 中 心 。 当 然 , 我 们 实现 了 客户 端 用 户 界面 , 但 是 ,在 其 实现 过 程 中 ,我 们 关注 的 是 为 生 
成 客户 端 上 的 用 户 界面 服务 器 需要 做 些 什 么 。 也 就 是 关注 构建 请 求 处 理 程序 , 以 及 请 求 处 理 程序 
所 需要 的 CSS 和 模板 。GWT 几 乎 完全 相反 ， 在 GWT 中 ， 开 发 者 将 重点 放 在 客户 端 。 开 发 者 使 用 
框架 构建 客户 端 用 户 界 面 , 看 起 来 就 像 传统 的 客户 端 应 用 程序 。 当 所 开发 的 客户 端 需要 服务 器 的 
内 容 时 ， 开 发 者 进行 远程 过 程 调用 (RPC，Remote Procedure Call )， 而 GWT 会 处 理 好 将 RPC 转 换 
为 AJAX 调 用 的 大 部 分 工作 。 

请 记 住 这 一 点 ， 现 在 让 我 们 开始 构建 一 个 GWT 应 用 程序 。 























































































































































































































9.2 Java 和 GWT 入 门 


首先 ， 我 们 来 看 一 个 基本 的 “Hello，World” 程 序 。Eclipse 的 GWT 工 具 自 动 生成 一 个 项 目 框 
架 ， 这 就 是 一 个 基本 的 GWT 的 “Hello，World” 程 序 。 因 此 ， 不 用 自己 编写 ， 我 们 只 需 让 Eclipse 
完成 即 可 , 然后 分 析 代 码 段 ,看 看 这 一 切 是 如 何 组 合 在 一 起 的 。 在 Eclipse 集成 环境 中 ,从 “文件 ” 
( File ) 菜单 选择 “新 建 ”( New )。 在 出 现 的 对 话 框 中 , 选择 “新 建 Web 应 用 程序 项 目 ”( New Web 
Application Project ), 然后 在 出 现 的 对 话 框 中 , 填写 项 目 名 称 和 Java 代 码 中 要 使 用 的 Java 包 的 名 称 。 
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我 选择 He11oChat 作 为 项 目 名 称 ， 选 择 com.pragprog.aebook.he11ochat 作 为 Java 包 的 名 称 。 
初始 应 用 程序 会 启动 一 个 页 面 ， 提 示 用 户 输入 名 字 。 用 户 输入 名 字 后 ， 会 弹出 一 个 对 话 框 ， 
显示 欢迎 语句 。 


9.2.1 GWT 应 用 程序 的 结构 


GWT 应 用 程序 由 一 组 模块 (module ) 组 成 。 模 块 就 是 一 种 包 ， 内 容 包 含 Java 代 码 、JavaScript 
代码 、HTML 文 件 、 图 像 、 数 据 定义 ， 以 及 开发 者 在 Web 应 用 程序 中 所 需要 的 其 他 任何 内 容 。 开 
发 者 在 Eclipse 集成 环境 中 创建 一 个 GWT/App Engine 项 目 时 ， 所 得 到 的 目录 结构 的 基础 就 是 它 所 
实现 的 GWT 模 块 的 结构 。 

首先 来 看 看 这 个 目录 结构 。 开 发 者 可 以 在 Eclipse 包 浏览 器 中 看 到 该 结构 ， 如 图 9-1 所 示 。 在 
App Engine 项 目 里 面 ， 有 GWT 库 的 集合 ， 外 加 两 个 主要 的 组 成 部 分 : 一 个 名 为 src 的 源 文 件 目录 
和 一 个 名 为 war 的 目标 文件 目录 。war 表 示 “ 网 络 存档 ”( web archive )， 开 发 者 上 传 到 App Engine 
的 可 部 署 应 用 程序 就 是 一 个 war 文 件 。 
































TE HelloChat 
Vsrc 
TBcom.pragprog.aebook.hellochat 
IX] HelloChat.gwt.xml 
b> 南 com.pragprog.aebook.hellochat.client 
宙 com.pragprog.aebook.hellochat.server 
> ES- META-INF 
国 los4j.properties 
> Bm App Engine SDK [App Engine - 1.2.6] 
> EN CWT SDK [GWT - 1.7.1] 
j> BR JRE System Library UVM 1.5.0 (MacOS X Def 
TE war 
bp SS- WEB-INF 
国 HelloChat.css 
着 HelloChat.html 








图 9-1 Eclipse 开发 环境 中 的 GWT 项 目 目录 结构 


源 文件 目录 本 身 也 分 为 3 个 部 分 : 模块 声明 、 客 户 端 Java 代 码 包 和 服务 器 端 Java 代 码 包 。 

服务 器 包 com.pragprog.aebook.hellochat.server 看 似 非常 简单 ， 只 有 一 个 微不足道 的 
源 文 件 ， 因 为 GWT 会 自动 生成 服务 器 端的 基础 结构 。 

客户 端 有 三 个 文件 ， 其 中 ，HelloChat.java 是 我 们 的 应 用 程序 的 主体 ， 男 外 两 个 是 
GreetingService.java 和 GreetingServiceImp1.Java, 是 GWT 远 程 过 程 调用 的 安装 部 分 。 这 
些 文件 包含 GWT 所 需要 的 声明 ， 因 此 不 必 显 式 地 设置 许多 XMLHttpRequest 就 可 编写 AJAX 客 户 
端 /服务 器 应 用 程序 。 我 们 将 在 9.3 节 中 学 习 一 下 这 些 文件 是 如 何 工作 的 。 

这 些 部 分 组 合 在 一 起 的 方式 是 由 GWT 模 块 声明 决定 的 。 





























workspace/HelloChat/src/com/pragprog/aebook/hellochat/HelloChat.gwt.xml 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE module PUBLIC "-//Google Inc.//DTD Google Web Toolkit 1.7.1//EN" 
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"http://google-web-toolkit.googlecode.com/.../gwt-module.dtd"> 


0 <module rename-to='hellochat'> 
<inherits 
© name="'com.google.gwt.user.User'/> 
<inherits 
3) name="'com.google.gwt.user.theme.standard.Standard'/> 


<entry-point 
@ class='com.pragprog.aebook.hellochat.client.HelloChat'/> 
</module> 


O@ GWT 中 的 基本 代码 单元 是 模块 ， 模 块 是 很 多 内 容 的 集合 ， 包 括 Java 代 码 、 资 源 ( 如 CSS、 
HTMIL 或 图 像 文件 ) 和 GWT 的 定制 ( 如 Java 到 JavaScript 编 译 器 的 扩展 )。 当 前 行 声明 了 包 
含 我 们 应 用 程序 的 模块 。rename 元 素 是 GWT 的 URL 处 理 的 一 部 分 : GWT 将 会 告诉 服务 
右 ， 在 以 hellochat 结 尾 的 URL 路 径 上 安装 该 模块 。 

@ GWT 中 的 模块 可 以 从 其 他 模块 继承 ， 其 工作 原理 很 像 面 问 对 象 的 继承 。 我 们 的 应 用 程序 
是 com.google.gwt.user.User 的 子 模块 ， 这 是 针对 有 用 户 界面 的 应 用 程序 的 一 个 标准 
模块 。 多 数 GWT 的 基本 功能 一 一 用 户 界 面部 件 、 远 程 过 程 调用 基础 架构 和 基本 的 服务 器 
端的 服务 设施 一 一 都 通过 此 标准 模块 的 声明 继承 。 

目 GWT 定 义 模块 有 两 方面 原因 ， 一 是 可 以 使 用 Java 代 码 的 类 继承 ， 二 是 GWT 模 块 中 除了 代 
码 还 有 很 多 资源 。 模块 可 以 包含 很 多 东西 ， 如 CSS。 该 继承 声明 将 定义 用 户 界 面 组 件 外 观 
的 CSS 文 件 放 到 我 们 的 应 用 程序 中 。 我 们 可 以 通过 继承 不 同 的 样式 模块 来 修改 应 用 程序 的 
外 观 。 

@ GWT 应 用 程序 的 Java 代 码 从 入 口 点 (entry point) 开始 。 入 口 点 基本 上 就 是 GWT 图 形 用 户 
界面 的 main 函 数 。 在 模块 文件 中 ,开发 者 声明 了 想 要 在 GWT 应 用 程序 中 执行 的 代码 入 口 
点 。 在 这 个 例子 中 ， 入 口 点 是 HelloChat 类 。 








































































































9.2.2 ”在 GWT 中 设置 用 户 界面 

在 GWT 模 块 内 ， 用 户 界 面 框架 由 HTML 文 件 定义 。 HTMLIL 文 件 不 是 源 代码 ， 因 此 ， 不 会 被 
放 在 src 目 录 下 。 它 是 一 个 静态 资源 ， 包 含 了 代码 要 使 用 的 信息 。 因 此 ， 这 个 HTMIL 文 件 被 放 在 
war 目 录 下 。 让 我 们 来 看 一 下 它 的 内 容 : 























workspace/HelloChat/war/HelloChat.html 


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<htm1> 
0 <head> 
<meta http-equiv="content-type" content="text/html; charset=UTF-8"> 
<link type="text/css" rel="stylesheet" href="HelloChat.css"/> 
<title>Web Application Starter Project</title> 
<script type="text/javascript" language="Javascript" 
© src="hellochat/hellochat.nocache.is"></script> 
</head> 
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<body> 
<hl>Hello World</h1> 
<table align="center"> 
<tr> 
<td colspan="2" style="font-weight:bold;">Please enter your name:</td> 
</tr> 


<tr> 
© <td id="nameFieldContainer"></td> 
<td id="sendButtonContainer"></td> 
</tr> 
</table> 
</body> 
</htm1> 


OQ@ HIML 框 架 文件 是 一 个 标准 的 HTML 文件 。 文 件 开头 是 通常 的 HTML 的 内 容 : DOCTYPE 
声明 ， 以 及 包含 通常 的 元 标签 的 头 部 。 
@ 这 是 整个 文件 中 最 重要 的 一 行 ! 之 所 以 该 HTML 文 件 需 要 放 和 人 GWT 应 用 程序 框架 ， 就 是 
因为 这 个 包含 了 JavaScript 文 件 的 代码 行 。 该 行将 放 和 人 由 GWT 生 成 的 JavaScript 文 件 中 , 后 
者 包含 了 应 用 程序 的 所 有 代码 。 
目 开发 者 可 以 使 用 HTML 文 件 中 定义 的 静态 结构 , 或 者 Java 代 码 中 定义 的 动态 结构 , 来 实现 
用 户 界 面 的 布局 ， 这 一 点 我 稍 后 会 更 加 详细 地 进行 解释 。 对 于 我 们 的 应 用 程序 而 言 ， 该 
HTML 框 架 为 主 用 户 界 面 页 面 定义 了 一 个 静态 结构 ,最 简单 的 实现 方法 是 使 用 HTML 语 言 
中 的 表格 功能 。( 正如 在 Python 代码 中 看 到 的 ， 我 们 也 可 以 使 用 CSS 的 浮动 框 来 实现 ， 但 
是 ， 如 果 想 要 做 动态 布局 ， 那 么 让 GWT 处 理会 更 好 。) 因此 ， 我 们 设置 了 一 个 两 列 的 表 : 
一 列 用 于 文本 输入 框 ， 另 一 列 用 于 “发 送 ”( Send ) 按钮 。 
@ HTML 静态 结构 不 仅 包括 静态 结构 ， 还 包括 静态 内 容 。 像 往常 一 样 ， 如 果 能 够 将 静态 内 
容 从 程序 逻辑 中 分 离 出 来 ， 我 们 就 应 该 这 样 做 。 因 此 ， 我 们 在 这 里 使 用 静态 帧 插入 一 个 
标题 行 ， 然 后 使 用 HTML 的 表格 布局 控件 ， 使 该 标题 行 跨越 表格 布局 中 的 两 列 。 
© 接 下 来 的 内 容 非 常 有 趣 。 我 们 在 这 里 做 的 是 在 用 户 界面 里 创建 一 个 空 区 域 。 < 标签 在 
HTML 布局 中 创建 一 个 区 域 , 但 它 是 空 的 一 一 标签 内 没有 任何 东西 。 在 Java 代 码 中 , 我 们 
插入 内 容 ， 然后 通过 id= 标 签 来 引用 它 。 我 们 创建 了 两 个 空 区 域 , 一 个 用 于 文本 框 , 一 个 
用 于 按钮 。 
现在 , 我们 分 析 一 些 代码 。 正 如 在 上 面 的 模块 声明 中 看 到 的 ， 应 用 程序 有 一 个 人 口 点 。 完 整 
的 入 口 点 方法 相当 长 : 既 包括 用 户 界面 元 素 的 创建 、 设 置 事件 处 理 程 序 ， 也 包括 建立 客户 端 / 服 
务 器 通信 的 远程 过 程 调 用 。 让 我 们 分 部 分 来 看 一 下 , 首先 从 构建 主 界 面部 分 开始 一 一 也 就 是 提醒 
用 户 输入 他 们 的 名 字 的 主页 面 : 9 
















































































workspace/HelloChat/src/com/pragprog/aebook/hellochat/client/HelloChat.java 


0 public void onModuleLoad() { 
final Button sendButton = new Button("Send"); 
final TextBox nameField = new TextBox() ; 
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nameField.setText("GWT User"); 
// 我 们 可 以 为 部 件 添加 样式 名 称 
(3) sendButton.addStyleName ("sendButton"); 


// 给 RootPane1 加 入 nameFie1d 与 sendButton 

// 使 用 RootPane1.get() 获取 the entire body element 
@ RootPanel.get("nameFieldContainer") .addCnameFie1d) ; 

RootPanel.get("sendButtonContainer") .add(sendButton); 


// 当 加 载 程序 时 ， 将 光标 焦点 定位 在 文本 输入 框 
© nameField.setFocus (true); 
nameField.selectA11QO; 


O@ 入 口 点 类 相当 于 GWT 下 的 main 函 数 的 容器 。 从 概念 上 讲 ， 它 确实 像 是 非 图 形 用 户 界面 工 
具 中 的 主 程序 。 但 在 Java 中 ， 因 为 一 切 都 需要 封装 在 类 里 ， 所 以 ， 必 须 围 绕 实 际 的 main 
函数 创建 一 个 框架 类 。 在 典型 的 GWT 应 用 程序 中 ， 这 是 定义 入 口 点 类 的 唯一 方法 一 一 它 
只 是 对 一 个 简单 方法 进行 的 过 于 复杂 的 包装 。 真 正 的 main 函 数 是 和 人口 点 的 onModuleLoad 
方法 ， 顾 名 思 义 ， 这 是 当 GWT 模 块 被 客户 端 加 载 时 ， 真 正 要 执行 的 内 容 。 在 此 方法 中 ， 
我 们 创建 用 户 界面 部 件 ， 对 其 进行 布局 ， 并 设置 事件 处 理 程序 。 

@ 我 们 在 onModuleLoad 内 做 的 第 一 件 事情 是 创建 用 户 界 面部 件 。 一 般 情 况 下 ， 其 构建 方式 
看 起 来 很 像 在 构建 一 个 非 浏 览 器 的 用 户 界面 。 我 们 创建 了 一 个 按钮 和 一 个 文本 框 ， 用 户 
将 在 文本 框 里 输入 他 们 的 名 字 。 

目 这 是 第 一 个 看 起 来 与 传统 的 非 浏览 器 用 户 界 面 不 同 的 地 方 , 该 代码 行 管理 部 件 样式 属性 。 
在 典型 的 图 形 用 户 界面 工具 集 里 ， 对 于 不 同 的 样式 属性 ， 会 有 一 组 相应 的 调用 方法 。 例 
如 ， 在 Mac OS 的 Cocoa 部 件 中 ， 我们 可 以 使 用 像 [button setGradientType: 
NSGradientConcavewWeak] 的 调用 来 修改 按钮 的 倾斜 度 。 在 GWT 中 ， 这 些 都 是 用 CSS 实 
现 的 : 通过 设置 CSS 属 性 以 创建 一 个 倾斜 的 图 片 作为 按钮 背景 ， 我 们 将 在 .gwt-Button 
CSS 样 式 块 中 增加 一 行 background: ur1("images/gradient.png")。 在 这 里 ,管理 样 
式 的 唯一 的 调用 就 是 用 来 设置 与 CSS 样 式 的 连接 。 样 式 名 称 被 GWT 转 换 为 一 个 CSS 的 
class= 属 性 。 刚 开始 它 看 起 来 可 能 有 点 奇怪 ， 但 是 用 起 来 确实 不 错 ， 它 有 助 于 保持 关注 
点 的 分 离 一 一 开发 者 确实 不 应 该 将 代码 与 视觉 样式 的 内 容 混杂 在 一 起 ， 而 应 该 将 所 有 样 
式 放 在 同一 个 地 方 。GWT 使 用 CSS 的 方式 为 开发 者 提供 了 一 种 真正 便捷 的 方式 实现 了 代 
码 与 样式 的 分 离 。 

@ 现在 ,我 们 到 了 布局 部 分 。GWT 提 供 了 一 个 图 形 用 户 界面 的 上 下 文 ， 基 本 上 就 是 浏览 器 
页 面 的 内 容 ， 称 为 RootPane1。 要 直接 访问 根 面板 ， 调 用 RootPane1.get() 即 可 。 我 们 
也 可 以 使 用 HTML 实 现 一 部 分 布局 ， 如 果 应 用 程序 的 主 HTML 页 面包 含 用 id= 属 性 命名 的 
元 素 ， 我 们 就 可 以 使 用 get Cname) 访 问 那 些 元 素 。 在 这 个 例子 中 ， 应 用 程序 的 根 页 面 确 
实 提供 了 应 用 程序 各 部 分 的 元 素 ， 这 是 非常 典型 的 GWT 风 格 : 我 们 要 在 静态 布局 (通过 
在 HTML 中 完成 ) 和 动态 布局 (通过 用 Java 编 写 布局 代码 ) 之 间 做 一 个 选择 。 通 常 ， 布 
局 几乎 是 固定 的 ( 像 在 这 个 例子 里 )， 写 一 个 HTML 表 格 并 用 Java 来 填写 表格 的 内 容 很 容 
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易 。 而 要 创建 动态 布局 ， 像 我 们 几 分 钟 后 会 看 到 的 对 话 框 ， 就 需要 使 用 GWT 的 布局 管理 
器 。 在 静态 布局 中 ,我 们 可 以 调用 get 在 页 面 上 放置 一 个 布局 区 域 , 然后 使 用 addCwidget) 
在 其 中 插入 图 形 用 户 界面 中 的 部 件 。 
© 最 后 ， 当 加 载 用 户 界 面 时 ， 我 们 和 希望 它 可 以 正常 工作 ， 也 就 是 说 ， 
在 文本 框 中 显示 相应 的 内 容 。 我 们 通过 设置 焦点 〈focus ) 实现 该 功能 , 焦点 是 指 在 屏幕 上 
接收 用 户 界面 事件 (如 按键 ) 的 部 件 。 用 户 可 以 通过 在 首 a 但 
是 如 果 焦 点 只 在 一 个 地 方 ， 会 是 一 件 很 麻烦 的 事 。 因 此 ， 我 们 将 焦点 设置 为 文本 输入 框 
我 们 还 让 其 自动 选择 放 到 该 区 域 的 占 位 符 文 本 ， 这 样 用 户 输入 的 文本 会 替换 占 位 符 。 
这 就 是 图 形 用 户 界面 的 基本 结构 , 我 们 留 了 另外 两 个 重要 的 部 分 。 应 用 程序 将 从 用 户 那 里 得 
到 用 户 名 , 将 其 发 送 给 服务 器 。 服 务 需 将 此 名 称 放 和 一 个 欢迎 消息 内 , 将 其 发 送 回 客户 端 ， 然 后 
显示 在 弹出 的 对 话 框 里 。 我 们 还 需要 做 的 是 把 客户 端 /服务 需 的 通信 和 对 话 框 组 合 在 一 起 。 在 下 
一 节 ， 我 们 将 了 解 客户 端 /服务 器 通信 。 首 先 ， 对 话 框 是 由 GWT 的 用 户 界 面 实现 的 ， 但 是 ， 对 话 
框 并 不 使 用 HTML 文 件 的 静态 布局 ， 而 是 完全 动态 的 : 
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workspace/HelloChat/src/com/pragprog/aebook/hellochat/client/HelloChat.java 


// 创建 弹出 式 对话 框 

OO final DialogBox dialogBox = new DialogBox(); 
dialogBox.setText("Remote Procedure Call"); 
dialogBox.setAnimationEnabled(true); 

©@ final Button closeButton = new Button("Close"); 
// 通过 访问 部 件 的 元 素来 设 定 部 件 ID 
closeButton.getElement().setId("closeButton"); 
final Label textToServerLabel = new Labe1(0) ; 
final HTML serverResponseLabel = new HTMLC) ; 

目 VerticalPanel dialogVPanel = new VerticalPane10) ; 
dialogVPanel.addStyleName("dialogVPane1"); 
dialogVPanel.add(new HTML("<b>Sending name to the server:</b>")); 
dialogVPanel.add(textToServerLabel); 
dialogVPanel.add(new HTML("<br><b>Server replies:</b>")); 
dialogVPanel.add(serverResponseLabel); 
dialogVPanel.setHorizontalAlignment(VerticalPanel .ALIGN_RIGHT); 
dialogVPanel.add(closeButton); 
dialogBox.setwWidget(dialogvPane1) ; 


closeButton.addClickHandler(new ClickHandler() { 
public void onClick(ClickEvent event) { 
dialogBox.hide(); 
sendButton. setEnabled(true); 
sendButton. setFocus (true); 
3 
了 ) ; 


QO 首先 ， 我 们 需要 创建 对 话 框 。 这 是 一 个 弹出 窗口 ， 因 此 它 不 包含 在 浏览 器 框架 里 。 这 意 
味 着 不 能 仅仅 抓 住 RootPane1 ， 而 需要 创建 一 个 独立 的 部 件 。GWT 为 此 提供 了 一 个 便捷 
的 部 件 : DiaglogBox ( 对 话 框 ) 是 一 个 独立 的 窗口 框架 , 可 以 般 入 任何 GWT 部 件 一 一 我 
们 只 需 创 建 它 的 内 容 ， 并 将 内 容 插入 到 对 话 框 中 。 因 为 对 话 框 是 一 个 窗口 ， 所 以 它 有 一 
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个 标题 栏 


钮 ,我们 稍 后 将 该 按钮 添加 到 对 话 








， 我 们 可 以 使 用 setText 方 法 设置 标题 栏 内 容 。 
@ 我 们 希望 用 户 能 够 在 他 们 需要 的 时 候 关 闭 对 话 框 ， 所 以 , 创建 了 一 个 “关闭 ”( Close ) 按 











EE 框架 中 像 往 常 一 样 , 可 以 使 用 CSS 设 置 部 件 的 属性 。 





在 这 个 例子 中 ， 我 们 直接 修改 HTML 代 码 。 对 于 给 定 的 任何 部 件 ， 可 以 通过 调用 
getE1ement() 获 取 部 件 相 对 应 的 XML 元 素 。 然 后 ,设置 它 的 ID ,让 CSS 样 式 可 以 使 用 XML 


元 素 的 setId() 方 法 引用 该 部 件 。 





“关闭 ”( Close ) 按钮 后 , 创建 了 男 一 组 部 件 。 有 一 个 Label1 ( 标签 ), 它 是 嵌入 在 部 件 中 的 
不 可 编辑 文本 。 然 后 ， 还 有 一 个 有 趣 的 部 件 一 一 HTML 部 件 ， 它 是 大 块 HTML 文 本 的 封装 。 
无 论 HTML 部 件 的 内 部 是 什么 ， 都 会 直接 显示 在 用 户 界面 的 HTML 页 面 中 。 这 对 于 骨 入 样式 


的 文本 非常 有 月 
































自 现在 ,我 们 将 放置 一 系列 元 素 。 
放置 它们 。 这 里 的 布局 只 是 很 多 元 素 的 垂直 堆 琶 。GWT 有 一 个 部 件 做 这 件 事 ， 就 是 
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日 ， 只 使 用 HTML 标 记 文 本 的 一 部 分 往往 比 产 生 相同 效果 的 编程 操作 容易 些 。 





于 没有 静态 的 HTML 框 架 ， 所 以 需要 由 GWT 指 定 如 何 














VerticalPane1。 我 们 只 需要 按照 


顺序 向 面板 中 添加 用 户 界 面 的 部 件 即 可 。 在 这 里 ， 要 


注意 HTML 标 记 , 因为 有 一 些 文本 我 们 想 要 用 粗 体 显示 。 我 们 并 没有 创建 一 个 Labe1 部 件 ， 
然后 设置 其 样式 属性 使 其 显示 成 粗 体 ， 而 只 是 将 该 文本 封装 到 <b> 标 签 中 。 

@ 我 们 已 经 将 用 户 界面 元 素 放置 在 VerticalPane1 中 。 剩 下 的 事情 就 是 告诉 对 话 框 ， 面 板 
应 该 显示 为 什么 样 ， 我 们 通过 设置 该 对 话 框 的 部 件 实现 该 功能 。 现 在 ， 对 话 框 的 视觉 部 
分 全 部 完成 。 开 始 的 时 候 ， 该 对 话 框 不 可 见 。 这 样 的 独立 部 件 ， 只 有 等 到 我 们 显 式 地 告 








诉 它们 可 














见 ， 




















它们 才 会 真正 出 现在 用 户 的 屏幕 上 。 稍 后 将 看 到 ， 我 们 可 以 告诉 对 话 框 它 


应 该 出 现在 什么 地 方 ， 从 而 使 其 可 见 。 大 多 数 时 候 ， 对 话 框 在 浏览 厂 窗 口 的 中 央 ， 所以， 
通过 调用 centerQ 〇 方法 就 可 以 使 对 话 框 可 见 。 


@ 设置 好 基本 的 月 





上 户 界 面 ， 我 们 终于 可 以 看 看 如 何在 GWT 中 人 处理 事件 了 ! 这 几乎 和 Java 的 





Swing 库 相同 。 创建 一 个 处 理 程序 对 象 , 使 用 addXXXHandler 方 法 将 其 附加 到 相应 的 部 件 
上 。 在 这 个 例子 中 ,我 们 要 附加 一 个 处 理 程 序 ， 当 用 户 点 击 “ 关 闭 ”( Close ) 按钮 时 ， 关 
闭 该 对 话 框 ， 因 此 ， 我 们 附加 了 C1ickHand1ler 对 象 。 在 它 的 onC1ick 方 法 里 使 对 话 框 不 
可 见 ， 并 启用 主页 的 输入 区 域 。 


9.3 GWT 中 的 远程 过 程 调用 


现在 我 们 进入 较 复 杂 的 部 分 。 

前 面 提 到 ，AJAX 代 码 在 GWT 中 不 是 显 式 编写 的 。 我 们 编写 了 称 为 远程 过 程 调用 ( RPC， 
Remote Procedure Call ) 的 代码 。RPC 看 起 来 几乎 与 正常 的 方法 调用 一 样 ， 但 在 后 台 ， 它 由 系统 
转换 成 从 客户 端 向 服务 器 发 送 的 请 求 。RPC 的 返回 值 是 服务 器 向 客户 端 发 送 的 响应 。 


就 像 任何 其 












































也 RPC 系 统一 样 , GWT 有 一 个 客户 端 和 一 个 服务 器 端 。 我 们 可 以 分 别 查 看 它们 的 


代码 ， 这 有 赖 于 GWT 的 RPC 系 统 将 它们 串 起 来 构成 一 体 。 





如 果 开 发 者 人 











过 分 布 式 编程 ， 可 能 并 不 习惯 于 使 用 Google 式 的 RPC。 传 统 上 ，RPC 试 图 尽 可 
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能 像 通常 的 函数 调用 一 样 出 现 。 换 句 话 说， 如果 我 们 想 要 提供 一 个 阶乘 函数 的 RPC ， 该 功能 的 实 

现 看 起 来 像 一 个 传统 的 函数 声明 ， 而 且 调用 看 起 来 也 像 一 个 传统 的 调用 。 例 如 ，Java 有 一 个 本 地 

的 RPC 层 ， 在 RPC 层 我 们 通过 接口 定义 一 个 远程 对 象 ， 然 后 就 可 以 调用 接口 类 型 对 象 的 方法 了 。 
我 们 可 以 定义 一 个 阶乘 服务 作为 Java 接 口 : 


public interface Fact extends Remote { 
int factCint n); 
} 


然后 ， 在 使 用 该 服务 的 代码 中 ， 我 们 获得 远程 接口 的 句柄 ， 像 下 面 这 样 直接 调用 它 : 

int j = f.fact(n); 

通过 这 样 的 封装 ,在 服务 器 中 做 好 了 准备 工作 , 使 得 该 对 象 可 用 ,这样 客 户 端 就 可 以 得 到 其 
句柄 ; 在 客户 端 也 是 同样 的 , 我 们 将 编写 持 有 远程 对 象 的 句柄 的 代码 。 但是, 调用 本 身 看 起 来 就 
像 一 个 普通 的 本 地 调用 。 

这 种 方法 有 一 个 问题 : 通信 慢 。 相 比较 于 本 地 调用 , 远程 过 程 调 用 可 以 很 容易 地 花费 两 个 数 
量 级 以 上 的 时 间 。 在 传统 的 调用 中 , 代码 将 停止 运行 并 处 于 等 待 状态 ,直到 得 到 从 服务 器 返回 的 
响应 。 这 在 时 间 上 是 一 个 巨大 的 浪费 ， 而 且 会 在 我 们 的 用 户 界面 中 带 来 令 人 无 法 接受 的 延 时 。 

因此 ，Google 为 远程 调用 提供 了 异步 (asynchronous ) 或 延续 传递 (continuation passing ) 的 
风格 。 调 用 本 身 并 不 返回 任何 内 容 , 但 是 ， 它 需要 一 个 额外 的 参数 ， 该 参数 是 一 个 函数 ， 当 RPC 
收 到 返回 值 时 ， 会 对 返回 值 调用 该 函数 。 

例如 ， 假 设 我 们 有 一 个 阶乘 服务 。 在 传统 的 风格 中 ,我 们 要 做 的 是 : 

System.out.println("Foo = " + Math.1og(3 * f.fact(n))); 

而 在 延续 传递 风格 中 ， 代 码 如 下 : 


f.fact(n, new AsynchCallback<int>() { 
public void onSuccess(int result) { 















































System.out.println("Foo = " + Math.1og(3 * result)); 
} 
了 ) ; 
我 所 做 的 只 是 将 原来 处 理 RPC 返 回 值 的 代码 封装 在 一 个 对 象 中 , 然后 将 该 对 象 作为 参数 传递 给 远 





程 调 用 。 代 码 实现 的 只 是 启动 这 一 进程 ， 然 后 ， 我 的 代码 就 可 以 去 做 其 他 事情 了 。 而 在 此 期 间 ， 
RPC 系 统 会 将 该 调用 转换 成 消息 ,发 送 这 一 消息 ,等 待 服务 器 发 送 响应 ， 然 后 将 响应 消息 转换 成 
结果 值 。 一 旦 返回 结果 ， 回 调 函 数 就 会 被 调用 ， 而 且 也 会 处 理 RPC 调 用 的 结果 。 

如 果 开 发 者 习惯 命令 式 编程 , 可 能 会 感到 有 点 不 习惯 。( 函数 式 编 程 人 员 一 直 都 是 这 样 做 的 ， 
即使 他 们 不 进行 分 布 式 编程 。) 开发 者 需要 一 些 时 间 来 习惯 这 种 编程 ， 即 使 习惯 以 后 ， 有 时 看 起 
来 也 似乎 有 点 别扭 。 但是， 总 体 而 言 ，RPC 不 必 等 待 的 优势 胜 过 其 存在 的 问题 。 它 使 得 应 用 程序 
可 以 更 好 地 啊 应 用 户 ， 而 这 才 是 最 重要 的 。 






















































































9.3.1 GWT 中 的 客户 端 RPC 
无 论 一 个 工具 包 多 么 强大 , 通信 永远 是 不 简单 的 。 我 们 需要 能 够 处 理 将 参数 转换 为 可 传递 的 
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消息 的 格式 ， 而 且 需 要 能 够 处 理由 于 网 络 造成 的 延迟 甚至 失败 。 为 了 处 理 这 些 问 题 ，GWT 使 用 
了 一 个 非常 Google 化 的 短语 ， 即 异步 RPC。 在 Google， 我 们 用 一 些 非常 独特 的 、 风 格 化 的 方式 去 
处 理 基 本 问题 ， 比 如 使 用 异步 响应 处 理 程序 进行 远程 过 程 调用 。 这 对 于 没有 使 用 Google 风 格 进行 
过 大 量 分 布 式 开发 的 人 来 说 非常 陌生 。 总 的 来 说 ，GWT 使 这 些 基 础 工作 对 用 户 不 可 见 是 非常 了 
不 起 的 。 然 而 ， 在 客户 端 RPC 中 ，GWT 不 这 样 做 。 

GWT 最 初 的 开发 是 为 了 Google 内 部 使 用 , 为 了 使 这 种 风格 变 得 自然 , Google 的 工程 师 花 了 很 
多 时 间 。 虽 然 它 有 一 点 怪 , 但 着 实 是 解决 很 多 RPC 的 传统 问题 的 最 简单 的 方法 。 使 用 异步 RPC， 
虽然 我 们 不 需要 在 客户 端 编写 多 线程 代码 , 但 仍然 需要 编写 实时 响应 更 新 的 代码 , 即 只 要 更 新 可 
用 就 要 对 其 进行 响应 ， 而 且 在 等 待 响应 时 不 会 阻塞 。 

说 这 么 多 背景 足够 了 ， 是 时 候 开始 深入 细节 了 ,来 看 看 在 GWT 中 编写 RPC 都 涉及 了 什么 内 容 。 
我 们 的 Hello World 程 序 有 一 个 远程 调用 ， 它 将 用 户 的 名 字 发 送 给 服务 右 ， 然 后 得 到 一 个 HTML 片 段 ， 
包含 给 该 用 户 的 问候 语 。 在 GWT 术 语 中 , 那 是 服务 器 上 的 代码 所 提供 的 一 个 服务 ( service ), 在 GWT 
中 做 的 第 一 件 事情 是 为 服务 方法 编写 一 个 同步 接口 ， 在 我 们 的 Hello World 应 用 程序 中 ， 这 就 是 所 谓 
的 问候 服务 。 出 人 意料 的 是 ， 问 候 服务 接口 是 编写 在 客户 端 软 件 包 里 的 。( 记 住 ，GWT 始 终 以 客户 
端 为 中 心 , 客户 端 是 接口 的 用 户 , 所 以 它 位 于 客户 端 软件 包 。) 基本 的 同步 问候 服务 接口 如 下 所 示 : 


workspace/HelloChat/src/com/pragprog/aebook/hellochat/client/ GreetingService.java 


package com.pragprog.aebook.hellochat.client; 
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import com.google.gwt.user.client.rpc.RemoteService; 
import com.google.gwt.user.client.rpc.RemoteServiceRelativePath; 


OQ QRemoteServiceRelativePpath("greet") 
© public interface GreetingService extends RemoteService { 
3 String greetServer(String name); 

} 


OQ GWT 服 务 接口 可 以 添加 注解 ， 说 明 它们 是 如 何 适应 应 用 程序 的 URL 结 构 的 。 应 用 程序 有 
一 个 根 URL， 所 有 的 应 用 程序 地 址 将 以 该 根 URL 作 为 前 级 。 此 注解 声明 了 该 服务 相对 于 

根 URL 的 路 径 。 因 此 ， 如 果 应 用 程序 是 在 http://gwt.appspot.com/foo， 那 么 这 个 服 

务 的 URL 将 是 http://gwt.appspot.com/foo/greet。 服 务 接口 应 该 总 是 按照 此 方式 声 

明 其 相对 路 径 的 。 

@ 服务 接口 声明 必须 是 GWT 接 口 com.google.gwt.user.client.rpc.RemoteService 的 
扩展 。 使 用 此 超级 接口 ,说 明 我 们 的 接口 是 为 了 在 GWT 应 用 程序 中 实现 其 服务 ,GWT 应 
将 其 转化 为 JavaScript。 

目 这 是 同步 方法 声明 。 任 何 一 个 服务 方法 的 参数 必须 是 java.1ang.Serializable 的 扩展 
或 者 是 针对 GWT 的 变种 com.google.gwt.user.client.rpc.IsSerializable 的 扩展 。 
这 里 要 理解 的 一 件 非 常 重要 的 事情 是 , GWT 使 用 Java 同 步 接口 标记 将 在 RPC 中 传递 的 类 ， 
并 不 表示 它 使 用 Java 序 列 化 。 使 用 IsSerializable 或 Serializable 仪 仅 是 一 个 标记 ， 
意 在 告诉 GWT 它 需要 生成 代码 来 序列 化 和 反 序列 化 该 类 型 。w- GWT 使 用 的 实际 格式 离 兼容 
Java 的 标准 序列 还 差 得 很 远 。 
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方法 声明 本 身 完全 标准 ， 但 它 只 是 个 普通 的 接口 方法 声明 。 

除了 同步 接口 ， 还 需要 编写 异步 接口 。 恕 我 直言 ， 这 里 我 很 迷惑 ， 为 什么 GWT 团 队 不 提供 
一 些 自动 化 的 文 持 。 要 生成 异步 接口 ， 只 需 编 写 另 一 个 接口 ， 它 纯粹 是 样板 下 的 同步 接口 。 异 步 
接口 必须 包含 与 同步 接口 完全 相同 名 称 的 方法 ， 每 个 方法 必须 返回 void 类 型 ， 每 种 方法 在 未 尾 
必须 增加 一 个 参数 ， 该 参数 是 AsyncCal11back， 其 类 型 参数 是 同步 方法 的 返回 类 型 。 例 如 ; 

































































workspace/HelloChat/src/com/pragprog/aebook/hellochat/client/ GreetingServiceAsync.java 


package com.pragprog.aebook.hellochat.client; 
import com.google.gwt.user.client.rpc.AsyncCallback; 


/* Ea 
*GreetingService 的 异步 接口 
*/ 
public interface GreetingServiceAsync { 
void greetServer(String input, AsyncCallback<String> callback); 
} 


异步 接口 与 同步 接口 没有 显 式 联系 , 也 没有 使 用 任何 特殊 的 注释 , 或 从 任何 特殊 类 继承 。 异 
步 接 口 确实 仅 供 客户 端 使 用 一 一 真正 地 在 异步 和 同步 接口 之 间 实 现 映射 的 基础 工作 是 由 GWT 生 
成 的 。 异 步 接口 的 唯一 目的 是 给 客户 端 提 供 将 要 使 用 的 调用 接口 。 


9.3.2 GWT 中 的 服务 器 端 RPC 


GWT 中 RPC 的 服务 器 端 非常 简单 。 我 们 只 需要 使 用 一 个 RemoteServiceServlet 的 扩展 类 ， 
就 能 实现 同步 客户 端 接口 。 对 于 我 们 的 问候 服务 ， 其 实现 如 下 : 



































workspace/HelloChat/src/com/pragprog/aebook/hellochat/server/GreetingServicelmpl.java 


package com.pragprog.aebook.hellochat.server; 
import com.pragprog.aebook.hellochat.client.GreetingService; 
import com.google.gwt.user.server.rpc.RemoteServiceServlet; 


/* x 
*RPC 服 务 的 服务 器 端 实 现 
*/ 
@SuppressWarnings("serial") 
public class GreetingServiceImp1 extends RemoteServiceServlet implements 
GreetingService { 


public String greetServer(String input) { 
String serverInfo = getServletContext() .getServerInfo(); 
String userAgent = getThreadLocalRequest() .getHeader("User-Agent"); 
return "Hello, " + input + "!<br><br>I am running " + serverInfo 
+ ".<br><br>It looks like you are using:<br>" 
+ UserAgent; 
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注解 suppressWarning 有 点 不 寻常 。 这 个 注解 之 所 以 放 在 这 里 ， 是 因为 在 后 来 的 Java 虚 拟 
机 版 本 中 ， 序 列 化 会 为 每 个 类 文件 生成 一 个 版 本 标识 字段 。 如 果 我 们 有 一 个 实现 java.1ang. 
Serializable 的 类 , 并 日 不 提供 版 本 标识 符 域 , Java 则 生成 一 个 警告 。 因为 RemoteServiceServlet 
从 标准 的 servlet 类 继承 ， 而 servlet 实 现 了 Serializable， 所 以 ， 服 务 的 实现 总 要 实现 
Serializable。 但是， 由 于 GWT 不 使 用 版 本 标识 符 ， 在 代码 中 包含 版 本 标识 符 只 会 引起 无 谓 的 
混乱 。 该 注解 用 来 防止 编译 器 生 成 令 人 费解 的 的 警告 消息 。 

这 就 是 我 们 需要 在 服务 器 端 做 的 所 有 工作 。 当 然 , 想 要 使 用 数据 仓库 实现 持久 性 时 , 会 更 加 
复杂 。 我 们 将 此 内 容留 到 下 一 章 中 。 

综 上 所 述 ， 现 在 我 们 已 经 为 这 个 简单 的 应 用 程序 实现 了 完整 的 远程 过 程 调用 。 这 比 在 Python 
中 使 用 AJAX 的 方式 更 简洁 : 我 们 有 定义 好 的 接口 ， 并 且 可 以 只 通过 方法 调用 来 调用 该 接口 。 不 
需要 担心 什么 创建 XMLHttpRequest 、 解 析 参 数 、 检 查 状 态 代 码 ， 或 者 任何 我 们 在 Python 中 做 的 
混乱 的 、 容 易 出 错 的 事情 。 


9.4 使 用 GWT 进行 测试 和 部 署 


现在 已 经 有 了 一 个 基本 的 GWT 应 用 程序 , 我 们 来 运行 该 程序 。 就 像 在 Python 中 一 样 ， 有 两 种 
在 App Engine 中 运行 GWT 应 用 程序 的 方式 : 本 地 模式 和 部 署 模式 。 本 地 模式 中 , 应 用 程序 在 开发 
者 的 机 器 上 运行 ; 部署 模 式 中 ， 应 用 程序 在 App Engine 云 中 运行 。 

GWT 的 本 地 模式 和 Python 的 本 地 模式 非常 不 同 。 在 Python 中 ， 本 地 模式 下 的 测试 很 友好 , 不 
需要 部 署 ， 但 是 ， 并 没有 真正 添加 能 够 支持 调试 的 方式 。 但 使 用 GWT， 在 本 地 模式 下 ， 客 户 端 
和 服务 器 都 运行 在 Java 中 , 我 们 可 以 使 用 Eclipse 的 所 有 功能 调试 GWT 应 用 程序 。 这 就 形成 了 巨大 
的 差异 : 我 们 拥有 了 断 点 、 踪 迹 、 单 步 ， 以 及 所 有 其 他 Java 调 试 工具 的 完整 支持 。 

要 使 用 Eclipse 在 本 地 模式 下 运行 , 到 “运行 ”( Run ) 菜单 下 , 选择 “作为 网 络 应 用 程序 运行 ” 
(Run As .../Web Application )。GWTI 将 打开 一 个 本 地 模拟 的 浏览 器 环境 ， 用 以 显示 客户 端 ， 并 局 
动 本 地 的 Tomcat 网 络 服务 器 执行 服务 需 端 代码 。 

要 将 应 用 程序 部 署 到 App Engine 中 ， 需 到 包 浏 览 右 视图 中 ， 右 击 该 项 目 。 在 出 现 的 项 目 菜单 
上 ， 有 一 个 Google 子 菜单 。 只 需 选 择 “ 部 署 到 App Engine”( Deploy to App Engine )， 开 发 者 的 程 
序 就 会 被 放 到 App Engine 云 中 。 如 果 有 任何 该 项 目 所 需要 的 有 关 信 息 ， 它 都 会 在 第 一 次 运行 部 署 
命令 时 提示 开发 者 填写 。 

我 们 完成 了 第 一 个 基本 的 GWT 应 用 程序 。 虽 然 还 没有 实现 Python 聊天 应 用 程序 的 全 部 功能 ， 
但 它 有 了 一 个 更 好 的 用 户 界面 和 一 个 更 清晰 的 通信 层 。 在 下 一 章 中， 我们 将 使 用 所 学 到 的 GWT 
知识 来 构建 聊天 应 用 程序 的 Java 版 本 ,在 这 个 过 程 中 ,我 们 将 了 解 Java 接 口 的 数据 仓库 , 以 及 GWT 
放置 在 服务 器 端的 Java 代 码 的 局 限 。 



































































































































在 前 面 的 章节 中 , 我 们 研究 了 App Engine 中 一 个 基本 的 GWT 应 用 程序 的 组 成 部 分 。 我 们 构建 
了 图 形 用 户 界面 ,建立 了 简单 的 远程 过 程 调用 , 并且 把 所 有 这 些 基 础 工作 串 了 起 来 , 使 应 用 程序 
能 够 运转 起 来 。 在 这 一 章 中 ， 我 们 将 使 用 GWT 来 实现 聊天 程序 。 我 们 不 会 花 太 多 的 时 间 讲 述 如 
何 构 建 图 形 用 户 界 面 ， 有 关 使 用 GWT 构 建 图 形 用 户 界面 有 成 批 的 书籍 GWT 自 带 的 用 户 界 面 类 
的 文档 也 都 讲解 得 非常 出 色 。 我 们 将 把 大 部 分 时 间 花 在 数据 仓库 ( datastore ) 上 ， 该 机 制 使 我 们 
能 够 在 App Engine 中 使 用 持久 性 数据 。 就 像 在 Python 中 一 样 ， 我 们 需要 做 一 些 额 外 的 工作 ， 使 类 
具有 持久 性 ， 并 且 可 以 查询 。 本 章 我 们 来 了 解 如 何在 Java 中 完成 这 些 工 作 。 

我 们 还 将 涉及 在 App Engine 环 境 下 使 用 Java 做 服务 器 端 基础 工作 的 一 些 其 他 问题 。 具体 地 说 ， 
App Engine 对 于 可 以 执行 什么 样 的 代码 ， 以 及 代码 在 云 环 境 中 如 何 运 行 施加 了 一 些 限制 ,我 们 将 
探讨 这 些 限 制 是 什么 ， 以 及 这 些 限制 对 我 们 编写 App Engine 应 用 程序 的 服务 器 端 有 何 影 响 。 


10.1 Java 中 的 数据 持久 性 


如 果 读 者 返回 去 看 一 下 第 4 章 ， 就 会 记得 ， 我 们 需要 在 Python 代码 中 做 一 些 额 外 的 工作 来 存 
储 数据 ， 使 程序 在 云 中 可 以 正确 运行 。 在 Java 中 ， 需 要 做 同样 的 工作 。 不 幸 的 是 ，Java 的 静态 类 
型 使 得 这 件 事情 变 得 更 为 繁琐 一 点 。App Engine 中 使 用 的 基本 的 后 端 数 据 仓库 和 在 Python 中 的 完 
全 一 样 ， 但 是 ， 要 让 它 在 Java 中 工作 ， 需 要 考虑 的 内 容 会 更 多 。 

当然 这 并 不 难 ， 但 我 们 需要 在 代码 中 放 和 人 更 多 样板 。Eclipse 照 例 可 以 为 我 们 处 理 很 多 事情 ， 
但 是 让 我 们 先 在 没有 Eclipse 的 帮助 下 开始 。 我们 将 手工 编写 所 有 的 代码 ,以 便于 理解 其 中 所 有 的 
细节 。 

在 典型 的 Google 风 格 中 ，App Engine 为 了 能 在 Java 中 使 用 数据 仓库 ， 其 所 做 的 工作 是 截获 标 
准 的 Java API， 即 Java 数 据 对 象 (JDO ，Java Data Objects )， 并 挑选 出 一 部 分 有 用 的 功能 。JDO 是 
一 个 非常 复杂 的 、 腑 肿 的 API ( 如 同 其 他 标准 一 样 )。 但 是 ，JDO 有 一 个 很 好 的 内 核 ，App Engine 
使 用 的 就 是 该 内 核 。 

下 面 ， 我 们 将 看 到 JDO 持 和 久 性 工作 的 原理 ， 即 它 是 如 何 描述 持久 性 对 象 ， 以 及 存储 、 查 询 和 
取 回 这 些 持 久 性 对 象 的 。 
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存储 Java 类 


在 Python 的 数据 仓库 接口 中 ,我 们 通过 给 类 对 象 增加 属性 创建 一 个 持久 类 。 在 Java 中 ， 我 们 
要 做 类 似 的 事情 ， 只 是 在 Java 中 ， 附 加 属性 要 通过 使 用 类 声明 中 的 注解 添加 。 通 过 例子 就 可 以 轻 
松 地 说 明 这 一 点 。 下 面 我 们 将 把 聊天 消息 转化 为 一 个 数据 对 象 : 


















































workspace/PersistChat/src/com/pragprog/aebook/ persistchat/ChatMessage.java 


package com.pragprog.aebook.persistchat; 
import java.util.Date; 


import javax.jdo.annotations.IdGeneratorStrategy; 
import javax.jdo.annotations.IdentityType; 

import javax.jdo.annotations.PersistenceCapable; 
import javax.jdo.annotations.Persistent; 

import javax.jdo.annotations.PrimaryKey; 


import com.google.appengine.api.datastore.Key; 


OQ QPersistenceCapable(identityType = IdentityType.APPLICATION) 
public class ChatMessage { 


public ChatMessage() { 
} 


public ChatMessage(String sender, String msg, String chatname) { 
this.senderName = sender; 
this.message = msg; 
this.chat = chatname; 


} 


© @PrimaryKey 
QPersistent(valueStrategy = IdGeneratorStrategy .IDENTITY) 
private Key key; 


3 Q@Persistent 
protected String senderName; 


QPersistent 
protected String message; 


Q@Persistent 
protected String chat; 


QPersistent 
protected long date; 


public Key getKey() { 
return key; 


} 
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public String getSenderName() { 
return senderName; 


} 


public void setSenderName(String senderName) { 
this.senderName = senderName; 


} 


public String getMessage() { 
return message; 


} 


public void setMessage(String message) { 
this.message = message; 


} 


public String getChat() { 
return chat; 


} 


public void setChat(String chat) { 
this.chat = chat; 
} 


public long getDate() { 
return date; 


} 


public void setDate(long date) { 
this.date = date; 
} 
} 


让 我 们 来 仔细 分 析 一 下 这 个 例子 。 

@ 对 于 一 个 要 存储 在 App Engine 数 据 仓 库 中 的 Java 对 象 ， 它 的 类 必须 声明 为 持久 性 的 。 在 JDO 
中 ， 开 发 者 可 以 通过 附加 一 个 PersistenceCapab1e 注 解 来 实现 类 的 持久 性 声明 。 在 完整 
的 JDO 中 ， 我 们 需要 声明 一 个 实体 类 型 。App Engine 只 支持 IdentityType.APPLICATION， 
但 是 ， 由 于 Java 的 类 型 系统 需要 注解 ， 以 匹配 其 声明 ， 所 以 必须 声明 该 字段 。 

@ 为 了 能 够 存储 、 取 回 或 搜索 某 一 特定 对 象 ， 对 象 必须 有 一 个 唯一 的 关键 字 以 供 识 别 。 在 
Python 中 ， 当 定义 持久 性 对 象 时 ， 框 架 会 自动 添加 一 个 不 可 见 的 关键 字段 ， 让 数据 仓库 

使 用 。 在 Java 中 ,所 有 内 容 都 需要 静态 声明 。 因 此 , 我 们 需要 手动 在 源 代码 中 插入 关键 字 
声明 ， 并 将 其 注解 为 关键 字 。 我 们 使 用 @PrimaryKey 注 解 将 其 标识 为 关键 字 ， 同 时 需要 
说 明 ， 比 较 主键 的 方式 是 通过 对 象 实体 ， 使 用 @Persistent 注 解 的 valueStrategy = 
IdGeneratorStrategy .IDENTITY 属 性 。 

大 多 数 时 候 ， 我 们 会 使 用 像 这 样 的 关键 字 对 象 ， 它 是 自动 初始 化 的 ， 并 且 通 常 不 会 直接 
使 用 。 我 们 稍 后 将 看 到 ， 可 以 做 一 些 关 键 字 的 定制 ， 但 通常 没有 必要 。 
目 持久 性 对 象 中 应 存储 的 每 个 字段 都 需要 用 @Persistent 注 解 。 
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在 Java 中 ， 数 据 对 象 有 一 些 限制 。 数 据 对 象 大 多 要 求 保 持 对 象 指针 的 可 维护 性 。 

口 当 一 个 持久 性 对 象 包含 男 一 个 持久 性 对 象 作为 字段 时 ， 它 拥有 该 对 象 ， 并 日 不 允许 其 他 

持久 性 对 象 引用 它 。 这 意味 着 ,我 们 有 时 需要 保存 对 和 象 。 

口 当 一 个 持久 性 对 象 包含 其 他 持久 性 对 象 的 集合 时 ， 它 拥有 该 集合 中 的 所 有 对 象 。 

口 我 们 局 限于 基本 的 Java 集 合 类 , 不 能 用 数组 ,也 不 能 使 用 任何 扩展 的 集合 类 型 。 我 们 可 以 
用 具体 的 类 ， 如 ArrayList、LinkedList、HashSet、TreeSet、Stack 以 及 Vector, 也 
可 以 使 用 更 抽象 的 接口 ， 如 List， 但 是 在 保存 或 者 重新 装 入 一 个 对 象 时 ， 我 们 不 能 保证 
恢复 的 对 象 的 列表 类 型 是 相同 的 〈 这 意味 着 ， 我 们 有 可 能 使 用 LinkedList 进 行 保存 ， 而 
使 用 ArrayList 进 行 取 回 )。 因 为 这 可 能 具有 相当 显著 的 性 能 影响 ， 我 建议 JDO 字 段 都 显 
式 使 用 具体 的 集合 类 型 。 

口 我 们 可 以 在 数据 对 象 中 通过 使 用 @Persistent(serialized=true) 注 解 标记 该 对 象 ， 从 
而 使 用 Java 序 列 化 类 型 。 需 要 注意 的 是 ， 序 列 化 数据 对 象 的 行为 与 开发 者 通常 期 望 的 Java 
行为 有 点 不 同 。 例 如 ， 假 设 我 们 在 一 个 持久 性 对 象 的 列表 字段 有 一 个 序列 化 对 象 的 两 个 
副本 。 如 果 我 们 保存 该 对 象 ， 然 后 加 载 它 ， 这 两 个 副本 不 能 保证 是 全 等 的 (== )， 而 且 它 
们 是 否 equals QO) 也 依赖 于 我 们 的 类 的 equals 0) 方法 是 如 何 实现 的 。 

口 String 类 型 的 字段 不 允许 超过 500 字 节 。 我 们 可 以 使 用 数据 仓库 中 为 该 字段 提供 的 Text 

类 存储 更 长 的 字符 串 ， 但 无 法 基于 该 字段 的 值 进行 查询 操作 。 

口 如 果 不 使 用 Eclipse, 则 需要 添加 一 个 额外 的 编译 步骤 , 称 为 代码 增强 ( code augmentation )。 
在 增强 过 程 中 ，App Engine 中 的 JDO 实 现 会 给 基于 持久 性 注解 的 类 添加 代码 ,使 它们 能 够 
被 数据 仓库 存储 和 查询 。 我 们 需要 确保 每 次 重新 编译 Java 源 代码 时 ， 都 会 执行 增强 过 程 。 
(Eclipse 自动 将 JDO 的 增强 包括 在 项 目 构建 中 ， 所 以 它 会 负责 处 理 好 这 一 切 一 一 这 是 使 用 
Eclipse 的 又 一 个 原因 ! ) 
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用 Python 在 数据 仓库 中 存储 东西 极其 简单 。 我 们 创建 一 个 持久 性 对 象 ， 然 后 调用 它 的 put 方 
法 就 可 以 。 转 眼 间 就 完成 存储 了 ! 用 Java 则 需要 做 更 多 的 工作 ， 主 要 是 需要 些 静 态 的 样板 。Java 
给 我 们 提供 了 很 多 优点 ， 但 它 确实 需要 更 多 样板 才能 完成 工作 。 

为 了 能 够 存储 和 取 回 对 象 ， 我 们 需要 一 种 称 为 PersistenceManagerFactory 的 工厂 。 工 厂 
的 创建 代价 非常 高 ， 我 们 不 想 每 处 理 一 个 请 求 时 都 重新 初始 化 工厂 ， 相 反 ， 先 做 好 工厂 的 设置 ， 
在 应 用 程序 加 载 到 App Engine 云 的 服务 器 上 的 时 候 创建 它 。 而 且 ， 我们 希望 工厂 创造 在 一 个 不 错 
的 、 集 中 的 地 方 ， 以 确保 任何 需要 PersistenceManager 的 人 都 知道 在 哪里 可 以 找到 该 工厂 的 实 
例 。 有 一 个 自然 的 解决 方案 一 一 单 件 设 计 模 式 。 我 们 将 创建 一 个 singleton 类 ， 用 它 静 态 创建 
PersistenceManager 的 单一 实例 ， 然 后 ， 该 实例 就 可 以 被 任何 需要 它 的 人 访问 了 。 
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workspace/PersistChat/src/com/pragprog/aebook/persistchat/serverPersisterjava 


package com.pragprog.aebook.persistchat.server; 


import javax.jdo.JDOHelper; 
import javax.jdo.PersistenceManager; 
import javax.jdo.PersistenceManagerFactory; 


public final class Persister { 


private static final PersistenceManagerFactory pmfInstance = 
JDOHelper .getPersistenceManagerFactory("transactions-optional"); 


private Persister() {} 


public static PersistenceManagerFactory get() { 
return pmfInstance; 


} 


public static PersistenceManager getPersistenceManager() { 
return get() .getPersistenceManager() ; 
} 
} 


现在 ， 任 何 需要 使 用 持久 性 管理 器 的 客户 端 代码 只 需 调 用 Persister.getPersistenceManagerGO 即 
可 。 使 用 持久 性 管理 器 ， 我 们 可 以 通过 调用 PersistenceManager.makePersistent(0) 存 储 对 
象 0， 接 着 可 以 调用 PersistenceManager.close()。 

















事务 

与 任何 人 讨论 分 布 式 应 用 程序 时 ， 你 会 不 断 地 听 到 事务 性 〈transactionality ) 这 个 词 。 
其 原因 如 下 。 

事务 性 可 以 防止 数据 被 破坏 。 如 果 没 有 事务 性 ， 万 一 在 存储 内 容 的 过 程 中 被 中 断 一 一 
因为 网 络 故 障 或 菜 台 计算 机 陷入 崩 演 一 一 就 可 能 会 使 数据 存储 不 一 致 。 

例如 ， 假想 开发 者 正在 编写 一 个 网 上 商店 。 开 发 者 创建 了 一 条 订单 记录 ， 指 示 运 货 部 


门 向 客户 发 货 ， 然 后 开发 者 又 创建 了 一 条 收费 记录 ， 告 诉 银行 如 何 收取 该 笔 货款 。 如 果 系 
统 在 存储 发 货 记录 和 存储 收费 记录 的 中 间 崩 演 ， 那 么 ， 就 可 能 导致 发 送 了 商品 ， 却 没有 收 
取 货 款 ! 
开发 者 想 要 这 两 个 步骤 是 原子 性 (atomic ) 的 ， 表示 要 么 两 者 都 成 功 地 储存 ,要么 就 都 不 
存储 。 这 种 要 么 全 部 都 存储 成 功 , 要 么 全 部 都 没有 存储 的 原子 单元 就 称 为 事务 (transaction )。 
Java 的 数据 仓库 提供 了 一 种 将 多 个 存储 操作 集合 为 一 个 单一 事务 的 方法 。 








这 比 Python 的 0.put() 调 用 麻烦 得 多 : 我 们 需要 设置 一 个 持久 性 管理 器 工厂 ， 分 配 一 个 10 
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PersistenceFactory， 然 后 完成 使 用 时 调用 close() 。 幸 好 这 样 做 还 有 很 多 好 处 。 采 用 
PersistenceFactory 的 接口 提供 了 对 事务 的 支持 。 从 分 配 一 个 持久 性 管理 器 起 ， 直 到 调用 其 
close0) 方 法 ,我们 所 做 的 每 件 事情 都 是 原子 性 的 一 一 也 就 是 说 ， 要 么 全 部 成 功 ， 要 人 么 全 部 失败 。 
我 们 存储 的 每 一 个 对 象 ， 每 一 次 对 持久 性 对 象 所 做 的 改变 , 要 么 全 部 存储 , 要 么 全 都 不 存储 。 这 就 
是 事务 的 美妙 之 处 ， 提 供 了 关系 数据 库 的 安全 性 。 样 例 代 码 看 起 来 似乎 很 麻烦 ， 但 也 确实 有 优势 。 

我 们 准备 要 发 布 一 条 新 消息 了 。 需 要 创建 一 个 RPC 服 务 ， 指 示 客 户 端 收 到 新 消息 要 发 布 时 将 
如 何 告诉 服务 器 。( 同样 地 , 值得 指出 的 是 , 在 GWT 中 , 我 们 将 发 布 操作 实现 为 一 个 异步 RPC 一 一 
从 程序 的 操作 角度 看 ， 这 正 与 它 的 真实 行为 相同 一 一 而 不 是 在 混乱 的 XMLHttpRequest 中 进行 追 
查 。) 我 们 的 RPC 服 务 需要 两 个 方法 ， 一 个 用 于 发 布 新 消息 ， 一 个 用 于 获取 消息 。 基 本 接口 如 下 
所 示 : 






























































workspace/PersistChat/src/com/pragprog/aebook/persistchat/client/ChatSubmissionService.java 


package com.pragprog.aebook.persistchat.client; 

import java.util.Date; 

import java.util.List; 

import com.google.gwt.user.client.rpc.RemoteService; 

import com.google.gwt.user.client.rpc.RemoteServiceRelativePath; 
import com.pragprog.aebook.persistchat.ChatMessage; 


QRemoteServiceRelativePath("chat") 

public interface ChatSubmissionService extends RemoteService { 
List<ChatMessage> postMessage(ChatMessage messages); 
List<ChatMessage> getMessages(String room); 
List<ChatMessage> getMessagesSince(String chat, Date timestamp); 


} 
像 往常 一 样 ， 我 们 将 其 变 成 异步 接口 : 
workspace/PersistChat/src/com/pragprog/aebook/persistchat/client/ChatSubmissionServiceAsync.java 


package com.pragprog.aebook.persistchat.client; 


import java.util.Date; 
import java.util.List; 


import com.pragprog.aebook.persistchat.ChatMessage; 
import com.google.gwt.user.client.rpc.AsyncCallback; 


public interface ChatSubmissionServiceAsync { 
void postMessage(ChatMessage messages, 
AsyncCallback<List<ChatMessage>> callback); 


void getMessages(String chatroom, 
AsyncCallback<List<ChatMessage>> callback); 


void getMessagesSince(String chat, Date timestamp, 
AsyncCallback<List<ChatMessage>> callback); 
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我 们 使 用 服务 器 包 中 的 类 实现 该 功能 ， 这 个 实现 起 来 非常 简单 。 我 们 用 刚刚 实现 的 
Persister 得 到 该 操作 的 PersistenceManager， 使 消息 对 象 具有 持久 性 ， 以 便 将 它 作 为 事务 的 
一 部 分 进行 保存 ， 然 后 关闭 持久 性 管理 器 ， 便 会 执行 该 事务 。 最 后 ， 我 们 使 用 另 一 个 服务 方法 ， 
从 服务 器 直接 调用 ， 从 而 把 聊天 室 的 更 新 消息 列表 提供 给 用 户 。 











workspace/PersistChat/src/com/pragprog/aebook/persistchat/server/ChatSubmission- 
Servicelmpl.java 


public List<ChatMessage> postMessage(ChatMessage message) { 
PersistenceManager persister = Persister.getPersistenceManager(); 
persister.makePersistent(message); 
persister.closeQ); 
return getMessages(message.getChat()); 


} 
如 果 我 们 想 将 任何 其 他 对 象 作为 与 聊天 消息 相同 的 事务 的 一 部 分 进行 保存 ， 只 需要 在 调用 
close() 之 前 添加 更 多 的 makePersistent() 来 存储 这 些 对 象 即 可 。 


10.3 ”在 GWT 中 取 回 持久 性 对 象 


Python 中 使 用 一 种 类 似 于 SQL 的 查询 语言 GQL， 从 数据 仓库 检索 并 取 回 对 象 。 在 Java 中 ， 我 
们 要 做 同样 的 事情 ， 但是， 我 们 所 做 的 工作 是 标准 的 Java 持 久 性 框架 的 一 部 分 ， 需 要 使 用 Java 的 
查询 语言 , 而 不 是 为 Python 构 建 的 客户 端 语言 。Java 数 据 对 象 的 标准 查询 语言 称 为 JDOQL。 和 GQL 
一 样 ， 它 看 起 来 很 像 SQL。 

说 实话 ， 我 们 并 不 真正 需要 使 用 DOQL。 如 果 知 道 我 们 要 取 回 的 对 象 的 关键 字 ， 可 以 使 用 
PersistenceManager 的 get0bjectById 方 法 来 获取 该 对 象 。 例 如 ， 如 果 x 是 一 个 聊天 消息 对 象 
的 ID ， 我 们 可 以 用 这 种 方式 取 回 对 象 x: 

PersistenceManager pm = Persister.getPersistenceManager() ; 

try { 

pm.getObjectByID(ChatMessage.class, x); 


} finally { 
pm.closeQ); 















































显然 , 上 述 代码 的 缺陷 在 于 , 我 们 必须 要 知道 关键 字 。 在 有 些 特定 的 情况 下 ， 要 取 回 一 个 对 
象 ， 但 是 我 们 既 不 知道 关键 字 ， 也 不 能 指出 它 是 什么 。( 我 们 将 在 第 13 章 中 学 习 如 何 解决 这 种 问 
题 。) 这 里 需要 做 出 权衡 : 通过 关键 字 获 取 对 象 比 通过 查询 语句 获取 的 速度 要 快 得 多 。 但 是 对 于 
我 们 的 聊天 应 用 程序 ( 以 及 许多 类 似 的 应 用 程序 ) 而 言 ， 执行 查询 语句 的 速度 与 封装 请 求 的 网 络 
通信 代价 相 比 , 实在 是 太 小 了 , 甚至 可 以 被 忽略 。 所 以 , 我 们 现在 在 聊天 应 用 程序 中 想 取 回 对 象 ， 
关键 字 检 索 并 不 是 特别 有 用 。 然 而 , 对 于 那些 在 单个 查询 过 程 中 就 需要 进行 很 多 数据 仓库 交互 的 
应 用 程序 ,权衡 的 结果 会 完全 不 同 ,通过 关键 字 获 取 对 象 将 会 极 大 地 影响 到 性 能 。 类 似 于 这 样 的 
权衡 在 云 编程 中 比比 丝 是 ， 开 发 者 需要 从 诸多 因素 中 找 出 对 性 能 至 关 重 要 的 影响 因素 。 
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在 上 述 代 码 中 ， 有 一 个 重要 部 分 : try.. .finally。 前 面 提 到 ， 持 久 性 对 象 不 是 轻 量 级 的 。 





持久 性 对 象 有 很 多 关联 的 资源 ， 它 挂 起 的 时 间 越 长 ， 就 会 积累 越 多 的 资源 。 开 发 者 必须 确保 关闭 
持久 性 对 象 ， 以 便 回 收 资源 。 如 果 没 有 使 用 try.. .final1y， 那么 一 旦 pm.getObjectById(.…) 
和 close) 之 间 的 任何 代码 遇 到 了 错误 或 抛 出 异常 ，close() 调 用 就 会 被 跳 过 ， 这 样 的 结果 会 非 
常 糟糕 。 这 不 止 是 存储 的 问题 ,更 是 取 回 的 问题 ， 因 为 当 开发 者 开始 一 个 存储 事务 时 ,通常 知道 
他 所 要 存储 的 所 有 内 容 ， 因 此 几乎 不 会 做 出 任何 可 能 产生 错误 的 计算 。 如 果 开 发 者 进行 了 计算 ， 
就 不 会 希望 通过 close (0) 提交 该 事务 了 ! 但 是 在 取 回 时 ， 开 发 者 经 常会 做 重复 的 事情 : 取 回 一 个 
对 象 ， 然 后 获得 希望 识别 的 其 他 对 象 的 信息 ， 再 取 回 其 他 对 象 ， 这 就 可 能 导致 错误 发 生 。 因 此 ， 
try...finally 块 的 安全 性 对 于 取 回 操作 很 重要 。 




































































大 多 数 时 候 一 一 特别 是 对 我 们 的 聊天 应 用 程序 而 言 一 一 我 们 将 使 用 JDOQL 查 询 语句 描述 想 








要 从 数据 仓库 取 回 什么 内 容 。 要 取 回 一 个 特定 聊天 室 的 所 有 聊天 消息 ,JDOQL 查 询 语 句 如 下 所 示 : 


select from ChatMessage 
where chat=desiredRoom 
parameters String desiredRoom 
order by date 


我 们 的 JDOQL 查 询 语 句 (事实 上 ， 大 多 数 JDOQL 查 询 语句 ) 有 以 下 4 个 部 分 。 

口 select from ChatMessage 
select 子 句 声明 查询 语句 要 搜索 的 对 象 集合 。 该 子 句 看 起 来 像 SQL 查 询 的 select 子 句 ， 
并 且 完 成 的 任务 也 基本 相同 。SQL 查 询 语句 选择 匹配 某 个 过 滤器 的 表 行 , 而 select 子 句 则 
说 明 从 什么 表 中 选择 。JDOQL 碍 询 语句 选择 匹配 某 些 过 滤 顺 的 一 组 对 象 ， 而 select 子 名 
则 说 明 从 什么 类 中 选择 。 如 果 要 取 回 ChatMessage 的 集合 ， 就 从 ChatMessage 类 中 选择 。 

口 where chat=desiredRoom 
where 子 句 与 SQL 中 的 where 很 像 : 它 提供 了 一 个 谓词 ( 即 ， 对 我 们 要 取 回 的 对 象 为 真 的 
表达 式 )。 我 们 希望 从 一 个 特定 的 聊天 室 取 回 消息 。 要 取 回 消息 的 聊天 室 的 实际 值 是 名 为 
desiredRoom 的 参数 。 

口 parameters String desiredRoom 
parameters 子 句 在 SQL 中 没有 任何 对 等 子 句 ， 但 是 它 应 该 存在 。 在 大 多 数 SQL 库 中 ， 必 
须 使 用 一 些 非常 痛苦 的 、 繁 拙 的 语法 来 声明 参数 。 在 JDOQL 中 ，parameters 子 句 声明 了 
一 个 类 型 变量 的 列表 ， 在 查询 字符 串 中 使 用 这 些 变 量 的 地 方 都 会 被 查询 调用 中 的 参数 值 
所 替换 。 因 此 我 们 说 desiredRoom 是 一 个 String 类 型 的 参数 。 

口 order by date 
order by 子 句 同样 与 SQL 中 的 order by 相同 : 它 声明 了 查询 语句 所 选 定 的 对 象 应 该 按 什 
么 顺序 返回 。 我 们 希望 按照 消息 发 布 的 顺序 看 到 聊天 消息 ， 所 以 按 日 期 排序 。 

JDOQL 还 有 男 一 种 语法 : 不 使 用 查询 字符 串 , 而 是 通过 编程 实现 该 功能 。 我 们 可 以 使 用 下 面 





















































的 代码 。 
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workspace/PersistChat/src/com/pragprog/aebook/persistchat/server/ChatSubmission- 
Servicelmpl.java 


@SuppressWarnings ("unchecked") 
public List<ChatMessage> getMessages(String chat) { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try { 
Query query = persister.newQuery(ChatMessage.class) ; 
query.setFilter("chat == desiredRoom"); 
query.declareParameters("String desiredRoom"); 
query.setOrdering("date"); 
return (List<ChatMessage>)query.execute(chat); 
} finally { 
persister.close(); 
} 
} 


这 段 代码 相当 简单 。@SuppressWarnings 是 Java 处 理 类 型 列表 方式 的 神器 ， 因 为 Java 使 用 称 
为 类 型 擦 除 的 技术 以 简化 类 型 集合 的 编译 ， 所 以 ,无 法 验证 一 个 类 型 列表 的 转换 是 否 有 效 。 由 于 
编译 需 不 能 保证 开发 者 不 犯错 误 , 因此 ， se 生成 一 个 警告 , 让 开发 者 知道 , 有 可 能 有 一 个 错误 。 
而 SuppressWarnings 注 解 就 是 告诉 编译 句 :“ 闭 嘴 , 我 知道 我 在 做 什么 !” 除 了 这 点 很 小 的 变化 ， 
这 一 段 代 码 与 我 们 上 面 所 看 到 的 查询 语 en 只 是 被 转换 成 了 编程 的 形式 。 最 
好 采用 这 种 方式 ， 因 为 它 将 查询 的 不 同 要素 分 开 ， 使 代码 更 容易 理解 。 


10.4 将 客户 端 和 服务 器 粘 合 在 一 起 


现在 ， 我 们 只 需要 告诉 App Engine 如 何 将 客户 端 和 服务 器 端的 代码 粘 合 在 一 起 ,使 聊天 应 用 
程序 的 客户 端 可 以 调用 RPC 方 法 ， 并 允许 它 从 数据 仓库 中 存储 和 取 回 消息 。 使 用 App Engine 的 
web .xm]1 就 可 以 完成 这 项 工作 ，web .xm]1 位 于 我 们 的 App Engine 项 目的 war/WEB-INF 目 录 下 。 
web .xm] 文 件 声 明了 我 们 应 用 程序 的 servlet 部 分 , 然后 告诉 App Engine 将 这 些 servlet 设 置 在 服务 器 
端的 位 置 ， 并 告诉 GWT 如 何 找到 它们 。 
















































































workspace/PersistChat/warWEB-INF/web.xml 


<?xm] version="1.0" encoding="UTF-8"?> 

<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd"> 


<web-app> 


<!-- Servlets --> 
0 <servlet> 
<servlet-name>chatServlet</servlet-name> 
<Servlet-class>com.pragprog.aebook.persistchat.server.ChatServiceImp1 
</servlet-class> 
</servlet> 
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© <servlet-mapping> 
<servlet-name>chatServlet</servlet-name> 
<url-pattern>/chat/chat</url-pattern> 
</servlet-mapping> 


<!-- 默认 服务 页 面 --> 
<welcome-file-1ist> 
<welcome-file>Chat.html</welcome-file> 
</welcome-file-1ist> 
</web-app> 
QO 告诉 App Engine， 为 了 运行 应 用 程序 需要 在 服务 器 部 署 哪些 servlet。 每 个 servlet 有 一 个 名 
字 ， 与 实现 它 的 类 相关 联 。 

@ 针对 servlet 子 句 所 声明 的 每 个 servlet， 向 App Engine 提 供 相 应 的 URL， 该 URL 就 是 应 用 

程序 运行 servlet 的 位 置 。 

在 这 一 章 中 , 我 们 构建 了 聊天 应 用 程序 的 基础 设施 : 有 了 客户 端 接口 ， 可 以 通过 RPC 发 布 新 

聊天 消息 和 取 回 信息 。 我 们 建立 了 RPC 方 法 的 servlet 实 现 ， 并 使 用 了 App Engine JDO 接 口 来 访问 
数据 仓库 。 通 过 这 些 工作 ， 我 们 学 习 了 如 何 从 数据 仓库 存储 和 取 回 对 象 的 基础 知识 。 
下 一 章 我 们 将 返回 到 用 户 界面 , 看 看 如 何 使 用 刚刚 建立 的 RPC 服 务 为 聊天 应 用 构建 一 个 非常 
漂亮 的 图 形 用 户 界 面 。 在 实现 过 程 中 会 探讨 可 用 的 图 形 用 户 界面 工具 。 我 们 将 涉及 如 何在 GWT 
中 创建 图 形 用 户 界面 布局 , 如 何在 用 户 界面 中 不 用 进行 完整 页 面 刷新 就 可 以 更 新 数据 显示 , 以 及 
如 何 啊 应 用 户 操作 。 

最 后 , 我 们 来 了 解 一 些 使 用 数据 仓库 的 更 复杂 的 方式 。 开 发 者 可 以 使 用 数据 仓库 做 很 多 非常 
有 趣 的 事情 ， 但 是 ， 也 受到 了 一 些 比较 特殊 的 限制 。 我 们 将 深入 研究 数据 仓库 的 功能 和 局 限 性 。 


10.5 参考 文献 和 资源 


口 Java 数 据 仓库 API，http://code.google.com/appengine/docs/java/datastore/。 

App Engine Java 数 据 仓 库 的 官方 文件 。 

口 Java 数 据 对 象 ，http:/java.sun.conyjdo/。 

JDO 标 准 文档 。JDO 是 Java 到 App Engine 数 据 仓库 的 接口 所 依赖 的 基本 技术 。 

口 “Java 持久 性 API” 一 一 一 个 实体 持久 性 的 简单 编程 模型 ，http://java.sun.com/developer/ 
technicalArticles/J2EE/jpa/。 

概述 App Engine 中 使 用 Java 持 久 性 API 的 一 篇 文章 。 
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现在 ， 大 家 已 经 了 解 了 如 何在 Google App Engine 中 使 用 Java 工 作 的 一 些 基 本 知识 。 我 们 学 会 
了 如 何 使 用 数据 仓库 进行 持久 性 数据 存储 的 基础 知识 ,研究 了 如 何 使 用 GWT 构 建 一 个 完整 的 Java 
云 应 用 程序 的 通用 结构 。 在 本 章 中 ,我们 将 更 详细 地 了 解 如 何 使 用 GWT 工 作 ， 构建 去 应 用 程序 
的 用 户 界面 。 


11.1 为 什么 使 用 GWT 


在 深入 之 前 , 值得 一 提 的 是 ， 开 发 者 并 不 是 非得 需要 使 用 GWT 构 建 采用 Java 的 App Engine 服 
务 。 开 发 者 可 以 使 用 任何 想 要 使 用 的 Java 网 络 应 用 程序 开发 框架 一 一 只 要 遵循 App Engine 运 行 时 
所 施加 的 一 些 限制 即 可 。( 在 App Engine 上 运行 的 Java 程 序 不 能 使 用 线程 、 锁 或 可 运行 对 象 , 这 些 
都 是 受 限 的 。) 

但 是 开发 者 可 以 使 用 大 多 数 常见 的 基于 Java 的 网 络 框架 。 开 发 者 可 以 使 用 标准 的 servlet 环 境 ， 
或 者 Struts, 甚至 Grails。GWT 并 不 是 App Engine 的 不 可 或 缺 的 部 分 , 那么 , 为 什么 我 要 关注 它 呢 ? 

一 部 分 原因 只 是 因为 我 喜欢 它 。 我 用 过 很 多 不 同 的 工具 包 构 建 网 络 和 基于 云 的 应 用 程序 。 以 
我 的 经 验 ，GWT 是 最 好 的 。 开 发 中 最 痛苦 的 地 方 ， 即 最 容易 出 问题 的 地 方 ， 都 可 以 由 GWT 中 行 
之 有 效 的 标准 代码 发 生 需 自动 生成 。 

再 就 此 问题 详细 说 明 一 下 。GWT 为 开发 者 做 的 是 ， 使 为 云 应 用 程序 编写 的 用 户 界面 和 为 普 
通 桌 面 应 用 程序 编写 的 用 户 界面 一 样 自然 。GWT 为 开发 者 提供 了 用 于 测试 和 调试 的 工具 ， 即 使 
开发 者 的 代码 使 用 了 不 同 的 语言 ， 也 很 容易 调试 一 一 就 好 像 是 开发 者 的 Java 服 务 器 和 客户 端 用 户 
界面 ， 实 际 上 是 用 JavaScript 或 者 HTML 5 运行 的 。 

这 就 是 GWT 最 有 价值 的 功能 。 我 们 知道 ， 云 编程 最 大 的 问题 往往 是 它 测试 和 调试 起 来 很 痛 
苦 ， 而 且 很 难 。 在 云 应 用 程序 中 ,开发 者 需要 处 理 客 户 端 程序 (HTML+JavaScript )， 加 上 实现 服 
务 器 端 所 使 用 的 编程 语言 ， 再 加 上 XML 和 HTTP， 这 已 经 非常 复杂 ， 但 是 还 不 止 于 此 。 开 发 者 不 
仅 需 要 处 理 这 些 语 言 ， 而 且 还 需要 处 理 各 种 语言 之 间 的 边界 。 开 发 者 不 仅 需要 编写 客户 端 上 的 
JavaScript 代 码 ， 而 且 所 编写 的 JavaScript 代 码 要 实现 各 种 功能 ， 包 括 如 何 生 成 HTTP 请 求 ， 如 何 解 
析 XML 响 应 ， 以 及 如 何 生成 JavaScript 对 象 。 开 发 者 的 服务 器 端 不 仅 需 要 有 执行 基本 操作 的 代码 ， 
而 且 需 要 知道 如 何 解析 HTTP 请 求 ， 以 找 出 客户 想 要 它 执 行 什么 操作 ， 同 时 ， 它 还 需要 获取 这 些 
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操作 的 结果 ， 并 翻译 成 XML。 客 户 端 和 服务 器 端 需要 就 请 求 、 响 应 和 XML 编码 是 什么 达成 绝对 
的 一 致 。 任 何 一 段 代码 ， 尤 其 是 语言 之 间 边 界 区 域 的 代码 ， 都 可 以 导致 微妙 且 难 以 发 现 的 问题 。 
我 曾 把 很 多 时 间 都 浪费 在 追查 由 XML 格式 或 HTTP 消 息 头 中 的 细小 失误 所 带 来 的 错误 上 。 

GWT 最 重要 的 地 方 ， 并 不 在 于 它 可 以 让 开发 者 像 使 用 本 地 用 户 界面 套件 似 的 部 件 来 编写 用 
户 界面 。 当 然 ， 那 是 非常 友好 ， 而 且 很 有 价值 的 ， 但 是 更 重要 、 更 有 价值 的 是 ，GWT 能 处 理 各 
种 不 同 的 语言 : 开发 者 用 Java 编 写 所 有 代码 ，GWT 负 责 将 Java 转 换 成 XML 、HTTP 、JSON、 
JavaScript、HTML 和 CSS, 并 且 生 成 跨越 语言 的 代码 。 在 GWTI 的 掩盖 下 ,底层 的 所 有 东西 仍然 保 
持原 状 一 一 但 是 通过 GWT， 开 发 者 不 需要 直接 处 理 底层 。 开 发 者 不 会 因为 各 个 语言 的 差异 而 产 
生 问 题 ， 这 样 所 节省 的 时 间 和 精力 是 非常 惊人 的 。 


11.2 ”使 用 部 件 构 建 GWT 用 户 界面 


现在 开始 使 用 GWT 来 构建 用 户 界面 。 我 们 将 在 聊天 应 用 程序 上 构建 一 个 基本 用 户 界面 ， 它 
与 我 们 前 面 用 Python 所 构建 的 用 户 界面 相同 ,只 是 这 次 采用 的 是 GWT。 首先, 我 们 集中 研究 真正 
的 用 户 界面 方面 一 一 除 某 些 必要 之 处 , 我 们 会 忽略 应 用 程序 的 逻辑 , 而 只 专注 于 应 用 程序 的 呈现 
方面 。 这 是 开发 者 构建 基于 GWT 的 App Engine 服 务 的 典型 方式 : 首先 要 搞 清楚 想 要 服务 做 什么 。 
正如 我 们 在 前 面 的 章节 中 所 做 的 那样 ， 先 找 出 想 要 管理 的 基本 数据 ， 以 及 需要 什么 类 型 的 RPC 调 
用 , 然后， 再 坐 下 来 使 用 GWT 组 建 用 户 界面 。 

和 很 多 用 户 界面 工具 套件 一 样 ， 在 GWT 中 ， 开 发 者 使 用 部 件 ( widget ) 进行 工作 。 部 件 是 用 
户 界面 的 基本 元 素 。GWT 提 供 了 开发 者 惯用 的 所 有 通用 用 户 界面 元 素 部 件 : 文本 框 、 按 钮 、 单 
选 按 钮 、 下 拉 菜 单 、 菜 单 ， 等 等 。 也 有 用 于 管理 布局 的 容器 部 件 ( container widget )。 如 前 所 述 ， 
这 种 整体 结构 是 我 们 使 用 GWT 的 一 个 重要 原因 , 因为 开发 者 不 必 担 心 如 何 编写 CSS 实 现 其 用 户 界 
面 布局 的 问题 , 也 不 必 弄 清楚 如 何 设置 所 有 的 JavaScript 来 绘制 其 用 户 界 面 。 开发 者 使 用 部 件 构 建 
其 用 户 界 面 ， 包 括 容器 部 件 ， 然 后 由 GWT 来 完成 剩 下 的 工作 。 开 发 者 可 以 专注 于 “做 什么 ”， 而 
不 是 “如 何 做 ”。 

在 传统 的 图 形 用 户 界面 工具 套件 中 , 开发 者 从 窗口 开始 , 然后 在 窗口 中 放置 部 件 。 使 用 GWT， 
开发 者 将 其 应 用 程序 放 在 一 个 网 页 中 ,然后 把 部 件 放 入 其 中 。 所 以 在 GWT 中 ,出 发 点 是 一 个 HTML 
页 面 。 开 发 者 可 以 把 任何 他 想 要 的 HTML 代 码 放 到 这 个 基本 页 面 中 。 事 实 上 ， 只 要 开发 者 想 , 他 
就 可 以 用 HIML 实 现 几乎 所 有 的 图 形 用 户 界 面 布局 。 早 在 第 9 章 ,我们 就 用 HTML 完 成 了 基本 布局 。 
不 过 实际 上 , 开发 者 没有 必要 这 样 做 , 他 可 以 使 用 一 个 完全 空白 的 HTML 页 面 , 并 且 只 使 用 GWT 
就 能 完成 所 有 布局 。 这 就 是 我 们 将 在 本 章 做 的 工作 。 我 们 仍然 需要 一 个 HTML 页 面 ， 因 为 加 载 云 
应 用 程序 的 唯一 方式 就 是 通过 网 页 。 因 此 ， 我 们 将 使 用 一 个 结构 最 少 的 页 面 ， 如 下 面 代码 所 示 。 
它 只 是 设置 加 载 GWT 用 户 界 面 的 链接 , 使 用 <link> 标 签 加 载 CSS, 使 用 <scrip 人 > 标签 加 载 用 户 界面 
代码 。 

先 从 HTMLIL 页 面 开 始 。 为 了 告诉 App Engine 哪 个 页 面 是 应 用 程序 的 主 框架 ， 我 们 按照 与 上 一 
章 相同 的 方式 编辑 web .xm] 文 件 。 我 们 喜欢 将 应 用 程序 的 主页 面 称 为 Chat.htm] ， 因 此 ， 只 需 编 
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辑 welcome-file-1ist 条 目 ， 如 下 : 


<welcome-file-1ist> 
<welcome-file>Chat.html</welcome-file> 
</welcome-file-1ist> 





<welcome-file-1ist> 
<welcome-file>Chat.html</welcome-file> 
</welcome-file-1ist> 


当 系 统 获 知 了 哪个 页 面 提 供应 用 程序 框架 之 后 , 我 们 就 可 以 通过 创建 Chat.htm1 页 面 设置 该 
框架 了 : 








workspace/PersistChat/war/Chat.html 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<htm1> 


<head> 
<meta http-equiv="content-type" content="text/html; charset=UTF-8"> 


<link type="text/css" rel="stylesheet" href="Chat.css"> 
<title>AppEngine Chat</title> 


<script type="text/javascript" language="javascript" 
src="persistchat/persistchat.nocache.js"> 
</script> 
</head> 


<body> 
</body> 
</htm1> 


上 面 的 代码 没有 太 多 内 容 , 它 是 一 个 非常 小 的 文件 。 主 体 部 分 完全 是 空 的 。 我 们 将 完全 使 用 
GWT 的 动态 布局 代码 来 填充 该 文件 ， 重 要 的 是 如 下 内 容 。 
口 一 个 指向 应 用 程序 的 .css 页 面 的 链接 。 开 发 者 通常 会 给 CSS 和 HTML 文 件 使 用 相同 的 名 
字 ， 因 此 ， 这 里 的 CSS 文 件 就 是 Chat .css。 
口 一 个 脚本 标签 ， 用 来 加 载 GWT 生 成 的 JavaScript 代 码 。 

有 了 该 页 面 作为 聊天 应 用 程序 的 框架 , 我 们 就 可 以 真正 开始 工作 了 。 这 个 聊天 用 户 界面 里 该 
有 什么 内 容 呢 ”让 我 们 来 看 看 此 之 前 的 图 7-2 中 组 装 的 样子 。 顶 部 有 一 个 标题 栏 ， 在 标题 栏 下 ， 
有 一 个 包含 当前 时 间 和 日 期 的 子 标题 ; 然后 ， 有 一 个 包含 聊天 室 列 表 的 区 域 ， 以 及 一 个 与 之 并 排 
的 含有 聊天 消息 的 区 域 。 这 些 区 域 下 面 ， 是 一 个 我 们 可 以 输入 新 消息 的 输入 框 ， 以 及 发 送 消息 的 
按钮 。 

在 GWT 中 ， 我 们 可 以 按照 刚才 描述 的 内 容 来 设置 用 户 界面 。 用 户 界面 的 基本 结构 是 垂直 布 
局 : 顶部 区 域 有 标题 和 子 标题 ,中 间 区 域 有 聊天 室 列 表 和 聊天 消息 ,底部 区 域 包 含 文本 输入 。 我 
们 希望 通过 编写 GWT 代 码 设置 这 些 部 件 ， 并 将 其 安排 在 用 户 界 面 中 。 
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在 GWT 中 ， 客 户 端 应 用 程序 总 是 从 调用 应 用 程序 主 类 的 onModuleLoad 方 法 开始 的 。 
onModu1leLoad 基 本 上 就 是 一 个 GWT 应 用 程序 的 主 函 数 , 而 且 , 因为 GWT 应 用 程序 需要 做 的 第 一 
件 事 情 就 是 设置 其 用 户 界面 , 所 以 应 将 用 户 界面 的 构造 代码 放 在 这 里 。 在 本 节 的 其 余部 分 , 我 们 
再 来 实现 onModuleLoad。 

先 从 创建 用 户 界面 的 基本 框架 开始 : 

















workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 
OQ final VerticalPanel mainVert = new VerticalPanel(); 
加 final VerticalPanel topPanel = new VerticalPanel(); 
final HorizontalPanel midPanel = new HorizontalPane1() ; 
final HorizontalPanel bottomPanel = new HorizontalPane1() ; 
©@ mainVert.add(topPanel); 


mainVert.add(midPanel); 
mainVert.add(bottomPanel1); 


@@ 为 了 使 用 一 系列 层 芭 的 用 户 界 面 元 素来 设置 用 户 界面 , 我 们 必须 创建 一 个 Pane1 ( 面板 ) 部 件 ， 
然后 将 其 他 元 素 插 入 该 部 件 中 。 首 先 创 建 一 个 VerticalPane1， 这 是 用 户 界 面 的 主要 元 素 。 
@ 现在 ， 要 创建 用 户 界面 的 垂直 元 素 。 我 们 需要 三 个 部 件 。 在 项 部， 需要 垂直 层 受 一 个 标 
题 栏 和 一 个 副标题 ， 所 以 ， 这 是 另 一 个 VerticalPane1; 在 中 间 ， 我 们 要 有 两 个 并 排 的 
部 件 ( 聊天 室 列表 和 聊天 记录 区 )， 所以， 这 是 一 个 HorizontalPane1; 最 后 ,底部 还 要 
加 上 输入 框 和 发 送 按钮 ， 它 们 同样 也 是 垂直 层 大 的 ， 因 此 ， 又 有 一 个 vertical1Pane1。 
现在 ， 我 们 要 把 标题 和 副标题 放 到 顶部 的 面板 中 : 






























































workspace/PersistChat/src/com/pragprog/aebook/persistchat/client/Chat.java 


OO final Label title = new Label("AppEngine Chat"); 
final Label subtitle = new Label(new Date() .toString()) ; 
© title.addStyleName("tit]le"); 
@ topPanel.add(title); 
@ topPanel.add(subtitle); 


QO 在 顶部 面板 中 ， 我 们 想 要 放置 两 个 部 件 ， 每 个 都 只 显示 一 些 文 本 。 在 GWT 的 用 户 界面 中 
加 入 文本 的 最 简单 的 方式 是 使 用 Labe1 ( 标签 ) 部 件 。 我 们 为 标题 和 子 标题 都 创建 了 标签 
部 件 。 因 为 标题 是 被 动 且 不 会 改变 的 ， 所 以， 我们 可 以 在 创建 它们 时 就 将 文本 放 到 其 中 。 

@ subtit1e 部 件 的 内 容 只 是 纯 文 本 。 但 对 于 标题 而 言 ， 我 们 要 使 它 看 起 来 有 些 不 同 ， 标 题 
中 的 文本 应 该 比 其 下 方 文本 更 大 、 更 粗 。 

大 多 数 用 户 界面 套件 提供 一 些 管理 样式 的 方法 ， 以 设置 文字 大 小 、 字 体 、 颜 色 等 。 事实 
上 , 我 们 已 经 知道 了 在 网 络 环境 中 的 设置 方式 , CSS 正 是 一 个 非常 友好 、 灵 活 的 管理 样式 
属性 的 方式 。 为 什么 要 推倒 重 来 呢 ? GWT 并 不 定义 新 的 API 来 实现 样式 ， 而 是 使 用 CSS。 
开发 者 不 需要 编写 太 多 代码 ，GWT 有 默认 样式 ， 可 以 使 部 件 看 起 来 更 美观 。 但 当 开 发 者 
要 自 定 义 某 些 内 容 时 ,仍然 可 以 使 用 CSS 声 明 属 性 。 在 应 用 程序 的 CSS 文 件 中 编写 开发 者 
想 要 的 样式 的 CSS,， 然 后 通过 调用 addStyleName("style") 告 诉 GWT 对 某 个 部 件 使 用 某 
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种 特定 的 样式 。 我 们 将 为 标题 标签 设置 apptit1e 样 式 。( 还 有 一 个 setSty1e 名 称 的 函数 ， 
但 是 ， 它 会 清除 与 该 部 件 相关 的 所 有 其 他 样式 属性 。GWT 能 自动 设置 很 多 属性 ， 使 部 件 
看 起 来 还 不 错 ， 因 此 ， 开 发 者 并 不 希望 清除 这 些 属性 。addStyleName 只 是 将 开发 者 的 样 
式 增加 到 CSS 级 联 中 , 因此 它 依 然 继承 了 所 有 样式 属性 , 而 不 是 开发 者 特别 设置 的 样式 。) 
我 们 稍 后 会 学 习 在 哪里 放置 CSS 的 内 容 。 

@ 创建 好 各 部 件 后 ， 我 们 需要 将 其 添加 到 面板 中 。 
上 面 的 代码 调用 了 addStyle 改 变 包 含 应 用 程序 标题 的 标签 部 件 的 外 观 。 我们 所 做 的 就 是 
插入 一 个 对 CSS 样 式 的 引用 ， 这 就 是 使 用 GWT 改 变 任 何 有 关 我 们 的 应 用 程序 部 件 的 风格 
要 做 的 工作 。GWT 在 设置 默认 值 方面 确实 做 得 不 错 ， 但 是 在 实际 的 应 用 程序 中 ， 开 发 者 
都 会 有 想 要 定制 的 地 方 。CSS 就 是 进行 定制 的 极 好 方式 , 它 以 标准 的 方式 提供 了 一 套 完 整 
的 样式 属性 , 通过 CSS 的 级 联结 构 , 可 以 很 容易 地 为 开发 者 的 应 用 程序 设置 通用 风格 , 并 
在 必要 的 地 方 进行 定制 。 

接 下 来 ,我们 改变 一 些 样式 ， 其 基本 的 模式 始终 是 相同 的 。 在 Java 代 码 中 ， 我 们 给 想 要 修改 
















































































样式 的 元 素 增 加 一 个 CSS 类 属性 ， 然 后 在 CSS 文 件 中 ， 为 其 编写 一 个 类 条 目 。 以 下 是 我 们 向 默认 
的 CSS 添 加 的 内 容 : 


workspace/PersistChat/war/Chat.css 


.title { 
font-size: 4em; 
font-weight: bold; 
color: #4444FF; 

} 


.messages { 
background: #AAAAFF; 
} 


.emphasized { 
font-weight: bold; 
background: #FFFF88; 

} 


我 们 实现 了 3 个 样式 类 。 我 将 详细 描述 第 一 个 ， 举 一 反 三 ， 其 他 两 个 应 该 就 可 以 理解 了 。 第 
一 个 CSS 类 是 应 用 于 刚刚 创建 的 标题 标签 的 。 我 们 想 使 标题 文本 变 大 而 且 加 粗 ， 并 且 使 用 彩色 背 
景 。 因 此 ， 在 CSS 类 中 ， 我 们 修改 其 font-size 属 性 使 之 变 大 ， 修 改 其 font-weight 属 性 使 其 加 
粗 ， 修 改 其 background 元 素 改 变 其 背景 颜色 。 

就 这 样 ， 我 们 完成 了 样式 的 改变 。 

我 们 还 需要 设置 其 他 两 个 子 面板 的 内 容 。 基 本 机 制 与 刚刚 看 到 的 相似 , 但 我 们 使 用 了 一 些 更 
有 趣 的 部 件 。 聊 天 列表 面板 特别 值得 关注 , 因为 它 的 内 容 是 一 组 基于 可 用 的 聊天 室 动态 生成 的 链 
接 。 这 有 点 复杂 ， 所 以 我 们 会 稍 后 分 析 此 内 容 。 首 先 来 看 看 其 他 子 面板 的 基本 布局 。 下面 是 中 间 
面板 的 基本 布局 代码 : 




















118 第 11 章 用 Java 构建 用 户 界面 





workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


OQ final VerticalPanel chatList = new VerticalPanel(); 
chatList.setBorderwWidth(2) ; 
final Label chatLabel = new Label("Chats"); 


@ Go ©® 


chatLabe1.addSty1eName("emphas7zeao") ; 
chatList.addCchatLabe1) ; 
chatList.setwidth(” 
populateChats (chatList); 

//"TextArea text" 被 定义 为 类 字段 ， 从 而 文本 区 域 可 以 被 处 理 方法 所 引用 
text = new TextArea() ; 

text.addStyleName(" 


了 0em") ; 


messages"); 


text.setwidth("60em"); 
text.setHeight("20em"); 
midPanel.add(chatList); 


midPanel.add(text); 





@ 我 们 要 将 聊天 列表 放 在 左边 的 列 里 ， 因 此 ， 创 建 了 一 个 垂直 面板 。 然 后 通过 将 其 边框 设 
为 2， 设 置 一 个 可 见 的 边框 ， 并 在 面板 上 面 放置 了 一 个 标签 。 





@ 正如 以 前 所 做 的 一 相 
样式 ， 其 定义 可 以 在 上 面 的 CSS 中 看 到 。 











和 A, 我 们 要 改变 聊天 列表 上 的 标签 的 样式 ,这 一 次 ,将 使 用 emphasized 








目 通常 情况 下 , GWT 根 据 面板 中 的 最 大 部 件 的 大 小 选择 默认 的 面板 大 小 。 我 们 想 要 多 些 控制 ， 
因此 显 式 地 将 其 宽度 设 为 10 em。10 em 看 起 来 似乎 是 随机 的 ， 其 实 不 是 。 显 示 聊 天 记录 的 


文本 区 域 将 是 60 em， 














因为 这 个 宽度 明显 能 够 适合 多 数 消息 。 在 试验 了 不 同 宽 度 后 发 现 ， 聊 





天 室 列表 的 宽度 是 聊天 记录 的 六 分 之 一 时 能 得 到 最 漂亮 的 外 观 。 如 果 聊 天 室 列 表 更 罕 ， 列 


表 外 观 会 显得 难看 、 


瘦弱 ; 如 果 聊 天 室 列表 更 帘 ， 则 会 在 窗口 的 左 侧 留 下 太 多 空白 。 


@ 为 了 填充 聊天 室 列表 中 的 内 容 ， 需 要 设置 一 些 RPC 和 回调 函数 。 把 内 容 般 入 在 构建 基本 
用 户 界面 布局 的 地 方 ， 多 少 显 得 有 些 笨拙 ， 而 且 违 背 了 我 们 关注 点 分 离 的 原则 。 用 户 界 
面 的 布局 是 一 个 关注 点 ，RPC 和 事件 处 理 是 男 一 个 。 因 此 ， 我们 只 调用 完成 此 工作 的 代 
码 。 稍 后 再 来 处 理 这 部 分 实现 。 

@ 最 后 ， 我 们 来 创建 文本 区 域 。 设 置 其 宽度 为 60 em， 高 度 为 20 em， 然 后 ， 添 加 完 所 有 刚 























刚 创建 的 面板 部 件 ， 























这 样 ， 我 们 中 间 部 分 的 布局 就 全 部 完成 了 ! 


最 后 ， 再 来 放置 底部 的 各 部 件 : 


workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


final Label label = new Label("FEnter Message:"); 
label.addStyleName ("bo1d"); 

final TextBox messageBox = new TextBox(); 
messageBox.setWidth("60em"); 

final Button sendButton = new Button("send"); 


bottomPanel.add(label); 


bottomPanel.add(messageBox); 
bottomPanel.add(sendButton); 
setupSendMessageHandlers(sendButton, messageBox); 


11.3 激活 用 户 界 面 : 处 理事 件 119 





几乎 是 相同 的 工作 。 先 创建 部 件 ， 再 对 它们 进行 布局 。 同 样 ， 我们 需要 设置 一 些 事件 处 理 程 
序 和 回调 函数 ， 而 且 仍 要 保持 关注 点 分 离 原则 ， 并 且 只 调用 一 个 设置 函数 。 

现在 , 我 们 已 经 完成 了 用 户 界 面 的 布局 ,布局 中 唯一 剩 下 的 事情 是 焦点 管理 。 用 户 界 面 的 焦 
点 就 是 选择 作为 任何 动作 的 默认 目标 的 部 件 。 如 果 用 户 开始 打字 , 焦点 就 是 接收 用 户 输入 的 字符 
的 部 件 。 从 某 些 方面 看 ,设置 焦点 是 个 小 细节 ， 但是， 从 开发 者 的 应 用 程序 是 否 流畅 运行 这 个 角 
度 来 说 ， 确 保 用 户 看 到 的 焦点 在 正确 的 地 方 将 会 产生 很 好 的 效果 。 















































下 载 workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


RootPanel.get().add(mainVert); 
// 设 定 指针 焦点 在 消息 框 中 
messageBox.setFocus(true); 
messageBox.selectA11QO; 
setupTimedUpdate QO); 


用 户 运行 一 个 聊天 应 用 程序 时 ,会 希望 能 够 开始 输入 聊天 消息 , 因此, 我 们 要 确保 让 他 们 输 
入 消息 的 部 件 是 活跃 的 。 


11.3 激活 用 户 界 面 : 处 理事 件 


现在 已 经 有 了 一 个 用 户 界面 ， 如 果 我 们 试 着 显示 一 下 ， 它 看 起 来 确实 不 错 。 但 是 ,该 界面 没 
有 任何 活动 性 内 容 。 它 不 知道 如 何 响应 用 户 发 生 的 任何 动作 ， 也 不 知道 如 何 从 服务 需 获 取 数 据 。 
在 GWT 中 激活 用 户 界面 的 关键 是 回调 函数 。 

到 目前 为 止 , 生成 的 这 个 用 户 界面 看 起 来 和 我 们 所 希望 的 一 样 , 但 它 完 全 是 被 动 的 , 不 做 任 
何事 情 。 为 了 使 用 户 界面 能 够 实现 预期 功能 ,我们 需要 设置 事件 处 理 程序 。 事 件 处 理 程 序 代 码 本 
质 上 是 异步 的 ， 完 全 由 回调 函数 构成 。GWT 的 事件 处 理 程序 代码 创建 的 对 象 ， 包 含有 处 理 特定 
事件 的 代码 ， 而 不 是 像 Windows 中 的 事件 循环 那样 ， 在 事件 循环 中 ,开发 者 要 编写 一 个 循环 监测 
用 户 接口 动作 ， 然 后 进行 决策 。 

在 考虑 处 理 用 户 动作 之 前 ， 还 需要 处 理 一 些 其 他 活动 。 还 有 一 部 分 用 户 界面 布局 工作 没 
做 一 一 那 就 是 活路 聊天 室 列 表 。 问题 是 , 我 们 不 知道 服务 器 上 存在 哪些 聊天 室 , 所 以 在 填充 用 户 
界面 时 , 无 法 直接 生成 该 列表 。 我 们 需要 检索 到 这 个 列表 ,并且 要 在 不 干扰 应 用 程序 显示 的 条 件 
下 完成 这 项 工作 。 

在 App Engine 中 使 用 GWT,， 这 个 过 程 很 有 代表 性 。 我 们 需要 发 送 一 个 请 求 到 服务 器 ,获取 歼 
天 室 列表 ,但 不 希望 在 等 待 响应 时 ， 程 序 就 这 样 暂停 ,并 且 在 用 户 的 窗口 中 不 显示 任何 内 容 。 在 
一 个 典型 的 Java 程 序 中 , 我 们 可 能 会 用 线程 处 理 该 问题 一 一 可 以 创建 一 个 Runnab1e 对 象 , 并 运行 
该 对 象 ， 完 成 取 回 和 填充 聊天 室 列表 的 功能 。 但 是 ，App Engine 所 提供 的 是 一 个 功能 有 限 的 受 控 
环境 ， 它 不 允许 我 们 创建 线程 。 
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继续 传递 编程 方式 


这 种 基于 回调 函数 的 编程 方式 ， 有 时 也 称 为 继续 传递 风格 ( CPS，continuation passing 
style ) 代码 ， 这 个 说 法 来 源 于 函数 式 编程 社区 。 其 基本 思想 是 : 任何 程序 都 可 以 被 写成 完 
全 异步 的 风格 。 当 代码 调用 函数 下 并 使 用 下 的 结果 时 ， 开 发 者 都 可 以 换 用 另 一 种 方法 来 代 
替 : 给 下 再 添加 一 个 新 参数 ， 这 个 参数 是 一 个 以 下 结果 为 参数 的 函数 ， 从 而 使 得 当下 产生 
结果 时 ,会 以 下 的 结果 再 调用 该 函数 。 

例如 两 个 数 相 乘 的 函数 : 

def multCm,n) : 

return mxn 
在 继续 传递 风格 中 ， 则 可 以 这 样 写 成 如 下 代码 : 


def cpsmult(m, n, done): 
done(m * n) 


如 果 开 发 者 想 要 用 GWT 进行 开发 ， 那 么 ， 继 续 传 递 风格 CPS 将 无 处 不 在 。 用 户 界 面 事件 
处 理 代码 基本 上 都 是 CPS 代码 ,而 且 GWT 中 的 RPC 的 异步 形式 也 恰恰 是 过 程 调用 的 CPS 形式 。 





我 们 可 以 使 用 GWT 的 异步 调用 ,涉及 好 几 个 步骤 。 需 要 给 包含 RPC 调 用 的 服务 添加 一 个 方 
法 ， 用 来 获得 聊天 室 列表 。 我 们 稍 后 会 详细 地 分 析 如 何 添 加 服务 获取 聊天 室 列表 。 然 后 在 
onModuleLoad 方 法 中 创建 一 个 垂直 面板 ,最 后 , 调用 populateChats 方 法 , 使 用 GWT 的 异步 RPC 
取 回 聊天 室 列 表 ， 并 填充 该 列表 。 具 体 代码 如 下 : 








workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


/* 
* 建 立 一 个 调用 ， 通 过 回调 来 获取 可 用 聊天 室 列 表 ， 
* 当 服务 器 响应 时 ， 会 创建 联接 部 件 并 把 它们 添加 到 ChatListPane1 中 。 
*/ 
public void populateChats(final VerticalPanel chatListPane1) { 
0 chatService.getChats(new AsyncCallback<List<String>>() { 
(2) public void onFailure(Throwable caught) { 


chatListPanel.add(new Label("Couldn't retrieve chats: "caught)); 
} 


(3) public void onSuccess(List<String> chats) { 
for (String chat : chats) { 
Button chatButton = new Button(Cchat) ; 
chatListPanel.add(chatButton); 


@ Chat.this.setupChatClickHandler(chatButton, chat); 
} 
setCurrentChat(chats .get(0)); 


有 
D; 
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这 是 一 个 RPC 和 异步 操作 的 相对 简单 的 用 法 ， 它 是 开发 者 在 App Engine/GWT 中 会 反复 使 用 的 基 
本 模式 。 
@ 后 成 一 个 RPC 调 用 。 我 们 并 不 是 一 直 在 活跃 地 等 待 响 应 ， 等 到 后 就 返回 ， 而 是 设置 一 个 
回调 对 象 , 它 会 在 RPC 的 结果 可 用 时 调用 。 这 种 模式 经 常 被 使 用 , 不 仅仅 是 在 RPC 中 。 由 
于 缺乏 线程 支持 ， 几 乎 在 我 们 会 使 用 典型 Java 程 序 的 线程 的 任何 地 方 ， 在 App Engine 中 都 
会 设置 某 种 回调 函数 。 换 句 话 说， 我 们 这 个 应 用 程序 几乎 所 有 真正 的 代码 都 在 回调 函数 
中 运行 。 
@ 在 大 多 数 时 候 ，RPC 应 该 成 功 。 正 如 读者 看 到 的 ， 我 们 在 编写 服务 器 端 代码 时 ， 服 务 器 
端 并 不 会 返回 一 个 错误 。 但 是 在 云 程序 中 ， 客 户 端 和 服务 器 之 间 总 是 有 另外 一 层 一 一 那 
就 是 网 络 。 网 络 层 是 一 个 潜在 的 出 错 来 源 ， 超 出 了 个 人 控制 ， 所 以 编程 要 仔细 ， 一 定 要 
考虑 周全 ， 提 前 做 好 各 种 准备 。 在 这 个 例子 中 ,我 们 将 以 一 种 非常 简单 的 方式 处 理 RPC: 
如 果 getChats 调 用 失败 ， 就 会 在 聊天 室 列表 部 件 中 放 和 一 条 错误 消息 。 
@@ 如 果 RPC 按 照 预期 希望 执行 成 功 ， 那 么 就 填充 聊天 室 列表 面板 。 针 对 每 个 聊天 室 ， 我 们 
创建 了 一 个 包含 聊天 室 名 称 的 Button 构 件 ， 并 把 它 添加 到 面板 中 。 
@ 然后 ， 我 们 需要 设置 事件 处 理 程序 。 点 击 某 个 聊天 室 按钮 时 ， 我 们 想 让 用 户 界面 做 有 所 
响应 ， 为 此 ， 需 要 设置 处 理 程序 。 我 们 将 在 下 一 节 来 看 一 下 如 何 实现 该 功能 。 
为 了 使 应 用 程序 能 够 响应 事件 并 执行 操作 , 需要 设置 事件 处 理 程序 (eventhandler )。 事 件 
处 理 程序 是 在 用 户 执行 应 用 程序 希望 关注 的 操作 时 被 调用 的 回调 函数 。 例 如 在 上 面 的 代码 中 ， 
我 们 只 是 创建 了 一 堆 用 于 选择 聊天 室 的 按钮 , 但 是 这 些 按钮 还 没有 任何 功能 。 因 此 ， 尝 试 下 面 
的 代码 : 


workspace/PersistChat/src/com/pragprog/aebook/persistchat/client/Chat.java 






























































protected void setupChatClickHandler(final Button chatButton, final String 
chat) { 
chatButton.addClickHandler(new ClickHandler() { 
public void onClick(ClickEvent event) { 
setCurrentChat (chat); 
text.setText("Current chat: " + chat + "\n"); 
currentChat = chat; 
chatService.getMessages(currentChat, new MessagelListCallbackQO); 
} 
了 ) ; 
} 


以 上 代码 给 一 个 按钮 附加 了 一 个 处 理 程序 ， 后 者 是 C1ickHand1ler 的 一 个 实例 。 点 击 按钮 时 ， 会 
调用 该 处 理 程 序 的 onC1ick 方 法 。 也 就 是 说 ， 当 用 户 点 击 一 个 特定 聊天 室 的 按钮 时 ,该 处 理 程序 
将 把 选 定 的 聊天 室 设 置 为 当前 的 聊天 室 ， 并 且 它 还 将 调用 RPC 从 选 定 的 聊天 室 中 取 回 消息 。 

为 使 聊天 应 用 正常 工作 , 我 们 还 需要 编写 更 多 事件 处 理 程序 。 当 用 户 试 图 点 击发 送 按钮 发 送 
聊天 信息 时 , 应 该 发 生 如 下 事情 : 系统 获取 文本 输入 框 中 的 内 容 , 将 其 作为 一 条 新 的 聊天 消息 发 
送 到 服务 器 ， 更 新 聊天 记录 ， 并 且 清 除 输入 区 域 ， 为 下 一 条 消息 做 准备 。 
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我 们 设置 一 个 回调 函数 ， 当 用 户 点 击 “ 发 送 ” 按 钮 或 者 在 消息 输入 区 的 文本 上 输入 回 车 键 时 
调用 它 : 





workspace/PersistChat/src/com/pragprog/aebook/persistchat/client/Chat.java 


private void setupSendMessageHandlers(final Button sendButton, 
final TextBox messageBox) { 
// 为 sSendButton 与 nameFie1d 创 建 事件 处 理 程序 
0 class SendMessageHandler implements ClickHandler, 
KeyUpHandler { 
/xs 当 用 户 点 击 sendButton 按 钮 时 调用 */ 
@ public void onClick(ClickEvent event) { 
sendMessageToServer(); 


} 


/** 当 用 户 在 nameFiel1d 按 下 回 车 键 时 调用 */ 
3 public void onKeyUp(KeyUpEvent event) { 
if (event.getNativeKeyCode() == KeyCodes.KEY_ENTER) { 
sendMessageToServer(); 
上 
} 


/** 发 送 聊 天 消息 给 服务 器 */ 
0 private void sendMessageToServer() { 
ChatMessage chatmsg = new ChatMessage(user, 
messageBox.getText(), getCurrentChat()); 
messageBox.setText(""); 
chatService.postMessage(chatmsg, 
new AsyncCallback<Void>() { 
public void onFailure(Throwable caught) { 
Chat.this.addNewMessage(new ChatMessage( 
"System", "Error sending message: ”十 
caught .getMessage(), 
getCurrentChat ())); 


} 


public void onSuccess(Void v) { 
ChatService.getMessagesSince(getCurrentChat() ， 
lastMessageTime, 
new MessageListCallback QO); 


了 ) ; 
} 
} 
© SendMessageHandler handler = new SendMessageHandler(); 
sendButton.addClickHandler (handler); 
messageBox.addKeyUpHandler (handler); 
站 


QO 我 们 正在 编写 的 是 一 个 将 被 两 种 事件 调用 的 处 理 程 序 。 当 用 户 点 击 “ 发 送 ”( Send ) 按 钮 时 ， 
以 及 当 用 户 在 消息 框 中 按 下 回 车 键 时 ， 该 处 理 程序 都 会 被 调用 。 我 们 需要 实现 处 理 每 个 事 
件 的 接口 : 对 于 按钮 点 击 ， 有 ClickHandler 接 口 ; 对 于 回 车 键 ， 有 KeyUpHandler 接 口 。 
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@ Cl1ickHandler 接 口 有 一 个 onC1ick 方 法 ， 任 何 时 候 点 击 按钮 ， 都 会 调用 该 处 理 程 序 的 
onC1lick 方 法 。 按 钮 点 击 处 理 程序 和 回 车 键 处 理 程序 做 的 是 同样 的 事情 ， 所 以 我 们 将 其 
抽象 为 一 个 函数 。 

目 KkeyUpHandler 接 口 有 一 个 onKeyUp 方 法 ， 该 方法 在 按 下 键 时 被 调用 。 主 要 的 区 别 是 
onKeyUp 在 按 下 任何 键 时 都 会 被 调用 ， 但 我 们 只 想 在 按 下 回 车 键 时 发 送 消息 。 因 此 ,我 
们 需要 做 一 个 测试 ， 以 检查 什么 键 被 按 下 ， 只 有 在 按 下 回 车 键 时 才 进 行 消息 发 送 。 

@ 这 里 是 实际 进行 处 理 的 地 方 。 首 先 ， 我 们 创建 聊天 消息 ， 然 后 ,使 用 惯用 的 GWT 的 异步 
方式 ,调用 GWT 的 RPC 消 息 。 

© 最 后 ， 我 们 创建 一 个 回调 对 象 的 实例 ， 将 其 注册 为 点 击 “ 发 送 ” 按 钮 或 者 在 文本 框 中 按 下 
回 车 键 时 的 事件 处 理 程序 。 


11.4 ”激活 用 户 界 面 : 更 新 显示 


至 此 已 经 布局 好 了 用 户 界面 , 并 且 构 建 了 回调 函数 和 事件 处 理 程序 , 使 应 用 程序 能 够 实际 做 
一 些 事情 以 响应 用 户 操作 。 但 我 们 仍然 缺少 了 一 个 关键 部 分 一 一 更 新 显示 。 当 用 户 选 择 一 个 聊天 
室 时 ,用户 界 面 应 该 被 更 新 ， 以 显示 选 定 聊 天 室 的 消息 ， 然 后 ,每 当 新 消息 发 布 时 ， 用 户 界 面 应 
该 保持 更 新 。 

在 上 节 的 事件 处 理 代码 中 的 选择 聊天 室 处 理 程 序 中 ( 以 及 其 他 一 两 个 地 方 )， 我 们 创建 了 
MessageListCallback。 这 段 代 码 实际 上 就 是 用 新 消息 的 集合 来 更 新 显示 。MessageListCallback 
的 使 用 方式 有 两 种 。 

(1) 当 用 户 选择 一 个 新 的 聊天 室 时 ， 调 用 它 来 显示 新 的 消息 。 在 这 种 情况 下 ， 它 取 回 该 聊天 
室 中 到 现在 为 止 的 所 有 消息 的 完整 列表 。 

(2) 为 了 保持 用 户 界 面 的 更 新 ， 我 们 有 一 个 被 定期 调用 的 回调 函数 ,不断 地 取 回 新 消息 : 该 
回调 函数 不 获取 聊天 室 中 的 所 有 消息 的 完整 列表 ， 只 是 获取 还 没有 被 该 客户 端 看 到 的 消息 列表 。 
(我 们 将 在 下 一 章 学 习 它 怎样 判断 哪些 消息 已 经 或 还 没有 被 客户 端 看 到 。) 

更 新 用 户 界 面 确实 很 容易 。 基 本 上 ,所 有 用 户 界面 部 件 都 有 方法 来 改变 其 内 容 ， 开发 者 只 需 
将 其 转换 为 字符 串 ， 然 后 将 它们 添加 到 部 件 中 。 

因此 ， 让 我 们 看 看 MessageListCallback: 





























































































































workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


public class MessageListCallback implements AsyncCallback<List<ChatMessage>> { 


public void onFailure(Throwable caught) { 
} 


public void onSuccess(List<ChatMessage> result) { 
addNewMessages (result); 
} 
} 
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protected void addNewMessages(List<ChatMessage> newMessages) { 
StringBuilder content = new StringBuilder() ; 
content.append(text.getText()); 
for (ChatMessage cm : newMessages) { 

content.append(renderChatMessage (cm)); 

} 
text.setText(CContent .toString(C)) ; 

} 


protected String renderChatMessage(ChatMessage msg) { 
Date d = new Date(msg.getDate()); 


String dateStr = d.getMonth() + "/" + d.getDate() + " "+ 
d.getHours() + ":" + d.getMinutes() + "." + d.getSeconds() ; 
return "[From: " + msg.getSenderName() + ”at "+ 


dateStr + "J]: " + msg.getMessage() + "\n"; 
} 


protected void addNewMessage(ChatMessage newMessage) { 
text.setText(text.getText() + renderChatMessage(newMessage)); 
} 


@ 回调 函数 本 身 其 实 很 简单 : 接收 消息 列表 , 将 其 添加 到 显示 , 并 且 只 调用 addNewMessages。 
@ addNewMessages 的 实现 几乎 一 样 简单 。 它 将 聊天 消息 作为 字符 串 显示 , 将 包含 新 消息 的 
字符 串 加 到 聊天 窗口 中 已 经 存在 的 消息 字符 串 之 后 ， 然 后 设置 窗口 内 容 。 

还 有 一 部 分 代码 ， 用 来 真正 激活 用 户 界面 ,使 其 按照 我 们 希望 的 方式 工作 。 我 们 希望 当 其 他 
用 户 发 布 新 消息 时 ， 用 户 界面 自动 更 新 。 在 云 环境 中 说 “一 旦 别人 发 布 消息 时 就 更 新 ,我 们 其 
实 并 不 知道 应 该 如 何 让 其 真正 地 工作 , 因为 客户 端 不 知道 别人 在 何 时 发 布 消息 。 客户 端 没 有 办 法 
知道 ， 只 有 服务 器 知道 ， 而 服务 器 只 能 响应 客户 端的 请 求 。 因 此 ， 我 们 创建 一 个 周期 性 的 更 新 : 
在 定期 调度 中 设置 一 个 会 自动 发 送 到 服务 器 端的 请 求 ， 用 来 查询 是 否 有 任何 更 新 。 这 是 一 种 在 
GWT 用 户 界 面 中 非常 通用 的 模式 ， 因 此 ， 在 GWT 中 很 容易 做 到 这 一 点 。 此 外 ， 当 然 ， 这 基本 上 
是 另 一 个 回调 函数 ， 称 为 定时 器 (Timer )。Timer 是 一 个 可 运行 的 对 象 ，GWT 会 在 调度 时 调用 。 
我 们 创建 并 设置 定时 器 作为 我 们 的 onModuleLoad 方 法 的 最 后 一 部 分 : 































































































workspace/PersistChat/src/com/pragprog/aebook/persistchat/ client/Chat.java 


private void setupTimedUpdate() { 

// 创建 一 个 新 的 定时 器 

Timer elapsedTimer = new Timer() { 
public void run() { 

chatService.getMessagesSince(getCurrentChat(), lastMessageTime, 
new MessageListCallback()); 

} 

下 

// 每 500 毫 秒 调用 一 次 定时 器 

elapsedTimer.scheduleRepeating(500); 

} 


定时 咒 对 象 的 创建 绝对 是 超级 标准 的 GWT 风 格 的 回调 函数 代码 。 我 们 创建 一 个 Timer 对 象 , 它 被 
调用 时 ， 定 时 器 向 服务 器 发 送 请 求 ， 请 求 更 新 。 在 更 典型 的 GWT 代 码 中 ， 提 供 了 又 一 个 回调 函 
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数 一 一 这 次 ， 是 一 个 在 更 新 请 求 返回 结果 时 才 会 调用 的 回调 函数 。 当 getMessagesSince 调 用 返 | 
回 时 ， 新 消息 将 会 通过 调用 addNewMessages 显 示 。 

定时 器 对 象 被 创建 之 后 , 我 们 只 需要 告诉 它 应 该 多 和 久 被 调用 一 次 。 对 于 一 个 响应 式 的 用 户 界 
面 ， 二 分 之 一 秒 是 一 个 不 错 的 时 间 间 隔 ， 因 此 ， 我 们 令 定 时 器 每 500 毫 秒 被 调用 一 次 。 





11.5 GWT 结束 语 


在 本 章 ， 我 们 组 装 了 聊天 应 用 程序 的 基本 图 形 用 户 界面 ， 研 究 了 构建 GWT 应 用 程序 的 基本 
机 制 。 我 们 看 到 了 如 何 创 建部 件 并 在 用 户 界面 中 放置 部 件 , 还 了 解 了 如 何 使 用 CSS 定 制 用 户 界面 
的 元 素 的 样式 。 我 们 研究 了 如 何 创建 事件 处 理 程序 ,并 将 其 附加 到 部 件 ,使 用 户 界 面 变 得 活跃 起 
来 ， 能 够 响应 用 户 操作 。 事 实 上， 我 们 已 经 看 到 了 使 用 Java 构 建 一 个 完整 的 App Engine 程 序 所 需 
要 做 的 一 切 工作 。 

下 一 章 将 把 所 有 的 内 容 整 合 到 一 起 。 我 们 将 完成 服务 器 端的 代码 ,以 及 与 服务 器 交互 的 客户 
端 逻辑 的 剩余 代码 。 在 此 过 程 中 ， 我 们 能 了 解 更 多 GWT 提 供 的 有 趣 服务 。 这 些 内 容 应 该 看 起 来 
都 很 熟悉 : GWT 使 用 继续 传递 回调 风格 的 相当 普遍 。 大 多 数 服 务 由 钩子 函数 提供 ， 我 们 可 以 把 
自己 的 回调 函数 附加 到 钧 子 函 数 上 。 到 下 一 章 结束 时 ， 聊 天 应 用 程序 将 全 部 构建 完成 ,并 部 署 到 
App Engine 中 。 


11.6 参考 文献 和 资源 


口 GWT 的 部 件 库 ，http://code.google.com/webtoolkit/doc/1.6/RefWidgetGallery.html。 
对 于 GWT 用 户 界 面 构建 者 最 有 用 的 资源 。 本 网 站 列 出 了 最 新 的 GWT 部 件 ， 每 个 部 件 都 有 
可 视 化 示例 , 还 有 关于 定制 部 件 所 使 用 的 CSS 属 性 的 完整 说 明 , 并 列 出 编程 所 使 用 的 事件 
处 理 程序 。 

口 GWT 2.0 开 发 者 指南 ，http://code.google.com/webtoolkit/doc/latest/DevGuide.html。 
官方 GWT 文 档 ， 描 述 开 发 者 可 能 想 知 道 的 关于 GWT 的 一 切 内 容 。 












































构建 Java 应 用 程序 的 服务 器 端 








我 们 已 经 构建 了 聊天 应 用 程序 的 大 部 分 代码 , 剩 下 的 就 是 客户 端 和 服务 需 端 之 间 的 连接 。 早 
在 第 10 章 ， 我 们 就 组 建 了 一 个 基本 的 RPC 接 口 ， 用 于 连接 客户 端 和 服务 器 端 。 不 幸 的 是 ， 自 从 建 
立 了 客户 端 以 后 ,整个 系统 就 变 得 不 太 正确 了 。 在 这 一 章 中 , 我 们 将 看 看 在 定义 该 接口 时 做 错 了 
什么 ,以 及 如 何 解决 这 一 问题 。 我 们 将 更 加 深入 地 了 解 在 服务 器 上 到 底 需 要 哪 类 对 象 和 方法 ， 然 
后 会 实现 缺失 的 部 分 。 我们 会 研究 除了 客户 端 请 求 的 处 理 程序 之 外 , 在 服务 器 端 还 需要 哪些 其 他 
内 容 。 最 后 ， 再 来 部 署 这 个 Java 聊 天 应 用 程序 。 
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如 果 读 者 认真 阅读 了 上 一 章 , 那么 就 会 发 现 , 我 在 一 些 客户 端的 方法 里 造假 了 。 在 第 10 章 中 
定义 的 RPC 接 口 只 有 两 种 方法 ,但 我 使 用 了 很 多 额外 的 方法 。 原 始 的 RPC 接 口 确实 没有 能 使 应 用 
程序 跑 起 来 的 全 部 内 容 。 当 开发 者 刚 开始 使 用 像 App Engine 这 样 的 系统 时 ， 常 常 容易 发 生 定义 的 
接口 不 完全 这 样 的 问题 。 

分 布 式 应 用 程序 编程 与 传统 的 应 用 程序 编程 非常 不 同 。 做 分 布 式 应 用 编程 , 系统 必须 极其 明 
确 地 分 成 客户 端 和 服务 器 端 两 部 分 , 如 果 开 发 者 还 不 习惯 用 这 种 方式 思考 ,就 很 容易 忘记 一 些 必 
需 的 基本 东西 。 

设计 原始 的 聊天 界面 时 , 我 们 将 重点 完全 放 在 如 何 获 得 和 发 布 聊 天 消息 上 。 毕 竞 , 这 是 一 个 
聊天 应 用 程序 中 的 两 项 基本 操作 。 

但 是 ， 聊 天 程序 还 有 很 多 其 他 内 容 。 聊 天 应 用 的 用 户 的 主要 活动 是 发 布 和 阅读 消息 。 为 了 发 
布 和 阅读 消息 , 用户 需 要 能 够 看 到 哪些 聊天 室 可 用 ,并 选择 其 中 一 个 。 我 们 需要 全 盘 思考 应 用 程 
序 的 整个 生命 周期 ， 而 不 能 只 专注 于 一 两 个 主要 活动 。 不 但 需要 考虑 用 户 如 何 开展 他 们 的 活动 ， 
而 且 还 需要 考虑 如 何 设置 必要 的 基础 设施 ， 才 能 开展 这 些 活动 。 
目前 完成 的 聊天 应 用 程序 缺失 了 以 下 两 项 重要 内 容 。 

口 需要 获得 可 用 聊天 室 列表 的 方法 ， 以 使 用 户 可 以 选择 他 们 和 希望 加 入 的 聊天 室 。 

口 需要 创建 聊天 室 的 方法 。 在 第 一 次 将 应 用 程序 部 署 到 服务 器 时 ， 数 据 仓 库 完 全 是 空 的 ， 
不 会 有 任何 聊天 室 。 为 了 生成 一 个 可 用 的 应 用 程序 ， 我 们 需要 设置 一 组 聊天 室 来 初始 化 
数据 仓库 ， 或 者 为 用 户 提供 茶 种 方法 来 定义 新 的 聊天 室 。 无 论 采 用 哪 种 方式 ， 我 们 都 必 
须 提 供 创建 聊天 室 的 调用 。 
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下 面 ， 让 我 们 开始 创建 这 些 缺 失 的 部 分 。 
12.1.1 实现 ChatRoom 类 


我 们 需要 给 接口 添加 几 个 新 的 RPC 方 法 ， 但 缺少 数据 类 型 。 如 前 所 述 ,我们 需要 能 够 创建 和 
查询 聊天 室 列表 。 要 实现 此 功能 ， 就 必须 有 一 个 持久 性 的 ChatRoom 类 。 [ 
ChatRoom 对 象 应 该 是 什么 样子 呢 ? 为 了 能 够 创建 和 查询 聊天 室 ， 并 不 需要 实现 得 太 过 复杂 ， 
事实 上 ， 我 们 唯一 真正 需要 的 就 是 聊天 室 名 称 。 
但 在 第 一 次 定义 该 接口 时 ,我 们 却 搞 砸 了 ， 漏 掉 了 真正 需要 的 东西 。 这 次 不 要 着 急 冒 进 ， 要 
仔细 些 ， 确 保 得 到 的 ChatRoom 类 的 设计 完全 正确 。 那 么 ,我 们 可 能 希望 在 聊天 室 列表 中 有 哪些 
内 容 呢 ? 能 想到 的 一 个 内 容 是 时 间 惟 , 时 间 截 包含 最 后 一 条 消息 发 送 到 该 聊天 室 的 时 间 。 通 过 时 
间 稚 ,我 们 可 以 在 用 户 界面 上 展示 给 用 户 哪些 聊天 室 是 活路 的。 因此， 我们 将 编写 一 个 持久 性 的 
聊天 室 对 象 ， 既 包含 聊天 室 的 名 称 ,也 包含 最 后 发 布 的 消息 的 时 间 稚 。 这 个 类 没有 任何 特殊 的 新 
内 容 。 它 是 一 个 典型 的 持久 性 App Engine 对 象 ， 因 此 ， 我 们 不 再 详细 讨论 。 下 面 就 是 代码 ; 




































































workspace/Chat/src/com/pragprog/aebook/chat/client/ChatRoom.java 


public class ChatRoom implements IsSerializable { 


String name; 
long date; 


public ChatRoom(String chat, long date) { 
this.date = date; 
this.name = chat; 


} 


public ChatRoom() { 
} 


public String getName() { 
return name; 


} 


public long getLastMessageDate() { 
return date; 


} 
public void updatelLastMessageDate(long d) { 
date = d; 


} 


12.1.2 持久 性 的 类 和 GWT 
现在 ,我 们 遇 到 为 数 不 多 的 GWT 将 Java 自 动 转换 成 JavaScript 的 策略 会 引发 问题 的 情况 。 我 
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们 已 经 有 了 聊天 消息 类 和 聊天 室 类 ， 既 可 以 用 在 RPC 调 用 中 , 也 可 以 用 在 服务 器 的 数据 仓库 的 持 
久 性 代码 中 。 问题 是 ， 如 果 用 持久 性 的 方式 使 用 该 类 ,该 类 就 需要 有 一 些 持久 性 注解 ,而 且 需 要 
一 个 持久 性 的 关键 字 。 但 是 ，GWT 不 能 将 注解 和 关键 字 转 化 为 JavaScript 的 内 容 ! 因此 ， 我 们 不 
能 对 GWT 的 RPC 使 用 持久 性 的 类 。 

我 们 也 不 能 使 用 这 些 类 的 GWT RPC 版 本 进行 持久 化 , 因为 RPC 类 不 具备 数据 仓库 JDO 实 现 所 
需要 的 注解 和 字段 。 因 此 ， 我 们 需要 为 每 个 类 实现 两 个 版 本 ,一 个 用 于 持久 化 ， 一 个 用 于 RPC。 
这 很 烦人 ,但 这 是 解决 这 一 痛苦 问题 的 最 简单 的 方式 。 

我 们 把 ChatMessage 和 ChatRoom 类 的 RPC 版 本 放 在 cl1ient 软 件 包 中 ， 把 它们 的 持久 性 版 本 
放 在 server 软 件 包 中 。 为 了 使 代码 变 得 更 容易 阅读 ， 我 们 在 类 的 持久 性 版 本 名 字 前 使 用 前 级 P， 
稍 后 在 对 这 两 个 不 同 版 本 进行 相互 转化 时 ， 就 会 明白 其 中 原因 。 

现在 ， 为 了 使 读者 可 以 看 出 其 中 的 差别 ， 来 看 看 新 的 ChatRoom 的 持久 性 版 本 。 我 们 刚刚 已 
经 看 过 了 它 的 RPC 版 本 ， 下 面 是 数据 仓库 中 的 持久 性 版 本 : 


























workspace/Chat/src/com/pragprog/aebook/chat/server/PChatRoom.java 


@PersistenceCapable(identityType = IdentityType.APPLICATION) 
public class PChatRoom { 
@PrimaryKey 
@Persistent(valueStrategy = IdGeneratorStrategy .IDENTITY) 
private Key key; 


QPersistent 
String name ; 


Q@Persistent 
long date; 


public PChatRoom() { 
} 


public PChatRoom(String chat, long date) { 
this.date = date; 
this.name = chat; 


} 


public ChatRoom asChatRoom() { 
return new ChatRoom(name, date); 


} 


public String getName() { 
return name; 


} 
public Key getKey(O) { 
return key; 


} 


public long getLastMessageDate() { 
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return date; 


} 


public void updateLastMessageDate(long d) { 
date = d; 
} 


} 


12.1 


Chat 


现在 ,我 们 已 经 完成 ChatRoom 类 ， 可 以 编写 使 用 它 的 方法 了 。 我 们 到 底 希 望 能 够 使 用 


.3 服务 器 端的 ChatRoom 方 法 





Room 做 什么 呢 ? 

口 创建 聊天 室 

需要 能 够 创建 聊天 室 。 

口 显示 聊天 室 列 表 

需要 能 够 得 到 一 个 可 用 的 聊天 室 列表 。 

口 删除 聊天 室 

这 是 可 选 的 ， 取 决 于 我 们 希望 系统 如 何 工 作 。 如 果 认 为 聊天 室 本 质 上 是 瞬间 的 一 一 也 就 
是 说 , 不断 地 创建 ， 然 后 丢弃 一 一 那么 我 们 希望 ,一旦 聊天 室 不 再 使 用 时 ， 有 一 种 方式 
可 以 清除 并 且 丢 弃 聊 天 室 。 男 一 方面 ， 如 果 和 希望 聊天 室 是 一 个 用 户 持 续 交 谈 的 永久 记录 ， 
那么 就 不 应 该 删除 聊天 室 。 
我 更 加 倾向 于 后 面 这 种 聊天 室 使 用 方式 。 大 多 数 聊 天 室 都 允许 用 户 持续 交谈 ， 我 可 能 今 
天 会 不 再 谈话 ， 但 很 有 可 能 到 明天 想 说 些 什么 时 ， 会 回来 继续 说 。 所 以 ， 我 决定 不 考虑 
删除 这 个 功能 。 

知道 了 所 要 的 方法 后 ， 我 们 就 可 以 将 这 些 方法 添加 到 ChatService。 新 方法 如 下 所 示 : 
































workspace/Chat/src/com/pragprog/aebook/chat/client/ChatService.java 


Wor 


List<ChatRoom> getChats() ; 


void addChat(String chatname); 


正如 一 直 在 GWT 中 所 做 的 一 样 ， 我 们 需要 给 该 接口 的 异步 版 本 添加 相应 的 方法 : 








kspace/Chat/src/com/pragprog/aebook/chat/ client/ChatServiceAsync.java 


void getChats(AsyncCallback<List<ChatRoom>> chats); 


void addChat(String chatname, 
AsyncCallback<Void> callback); 


这 些 实现 都 大 同 小 异 。getChats 几 乎 是 最 简单 可 行 的 JDOQL 查 询 ， 它 获取 所 有 ChatRoom 类 

















型 的 对 象 并 将 其 返回 ， 如 下 所 示 : 
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workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


@SuppressWarnings("unchecked") 
public List<ChatRoom> getChats() { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try { 
Query query = persister.newQuery(ChatRoom.class) ; 
query.setOrdering("date"); 
return (List<ChatRoom>)query.execute(); 
} finally { 
persister.close(Q); 
} 
} 


添加 新 聊天 室 会 稍微 复杂 一 些 。 我 们 需要 建立 一 个 聊天 室 对 象 ， 并 使 其 具有 持久 性 : 











workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


public void addChat(String chat) { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try 荆 
PChatRoom newchat = 
new PChatRoom(Cchat，9System.currentTimeMi11is(C)) ; 
persister.makePersistent(newchat); 
} finally { 
persister.close(); 
} 
} 


12.2 适当 的 交互 式 设计 : 增 量 式 设计 

原来 的 接口 还 有 男 一 个 大 问题 。 我们 只 提供 了 一 个 消息 , 用 来 在 指定 的 聊天 室 中 获取 所 有 的 
消息 。 构 建 的 用 户 界面 中 ， 聊 天 室 从 不 会 被 删除 ， 因 此 ， 消 息 只 会 不 断 地 累积 。 同 时 ， 我 们 希望 
应 用 程序 是 交互 式 的 ， 这 也 就 意味 着 ， 它 会 不 断 地 更 新 消息 的 显示 列表 。 当 我 们 考虑 这 两 点 后 ， 
就 会 发 现 它 既 浪费 资源 ， 又 损失 性 能 ， 因 为 必须 不 断 地 重新 发 送 整个 消息 列表 。 即 使 假设 我 们 只 
在 发 布 新 消息 的 时 候 取 回 消息 列表 ， 也 意味 着 在 客户 端 ， 我们 第 一 次 发 布 消息 时 要 取 回 消息 一 ， 
第 二 次 要 取 回 消息 一 和 消息 二 , 第 三 次 是 消息 一 、 二 、 三 , 然后 是 一 、 二 、 三 、 四 …… 依 此 类 推 ， 
到 第 十 条 消息 时 , 我 们 已 经 将 消息 一 发 送 了 十 次 。 回 想 一 下 ， 系 统 会 每 秒 自动 更 新 两 次 ,也 就 是 
说 ， 在 使 用 系统 的 一 分 钟 内 ， 我 们 将 获取 相同 的 消息 120 次 。 

这 可 不 是 云 应 用 程序 应 有 的 工作 方式 。 假想 一 下 ，, 应 用 程序 并 不 会 只 有 一 个 用 户 , 它 有 上 百 、 
上 千 ,， 或 者 更 多 用 户 ! 假设 有 一 干 个 用 户 时 ,我 们 每 秒 会 将 同一 个 旧 消 息 重新 发 送 12 万 次 ,这 可 
不 仅 是 浪费 时 间 ， 而 且 也 是 浪费 钱 ! 在 App Engine 中 ， 我 们 要 为 所 用 的 资源 付费 。 如 果 每 一 秒 钟 
都 将 同一 内 容重 新 发 送 10 万 次 ， 免 费 资源 将 会 很 快 用 尽 ， 然 后 就 该 为 所 用 的 带宽 付费 了 。 

绝 不 能 这 样 做 。 在 真正 的 云 应 用 程序 中 ， 我 们 并 不 是 非常 担心 CPU 时 间 ，CPU 时 间 很 便宜 。 
我 们 关注 的 是 通信 , 因为 通信 的 时 间 和 人 金钱 都 很 昂贵 。 与 计算 这 些 内 容 所 耗费 的 时 间 相 比 ， 通 过 
网 络 发 送 内 容 简直 慢 得 难以 想象 。 绝 大 多 数 时 候 , 设计 工作 的 重点 应 在 于 如 何 最 大 限度 地 降低 通 
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信 。 多 次 重新 计算 相同 的 内 容 比 通过 网 络 发 送 一 次 内 容 更 快 、 更 便宜 。 

对 于 这 个 聊天 室 范例 来 说 ， 没 必要 给 单一 的 客户 端 重新 发 送 消 息 。 客 户 端 可 以 记 住 它 已 经 
看 到 的 消息 ， 从 而 只 需要 将 新 消息 添加 到 其 列表 中 即 可 。 在 这 个 程序 的 云 实现 中 ， 可 以 基于 时 
间 取 回 列表 进行 更 新 一 一 也 就 是 说 ， 我 们 可 以 告诉 服务 需 端 :“ 给 我 上 次 查询 之 后 的 所 有 聊天 
消息 。 

这 种 工作 方式 称 为 增 量 式 〈incremental ) 更 新 。 我 们 并 不 是 重新 获取 整个 数据 集合 ， 而 是 在 
客户 端 和 服务 骨 端 同时 管理 数据 的 副本 ， 并 只 发 送 很 小 的 修改 。 对 于 几乎 所 有 云 应 用 程序 而 言 ， 
如 果 硕 望 它 操作 高 效 且 负载 得 起 ， 那 么 我 们 就 需要 将 其 设计 为 增 量 式 更 新 。 


12.2.1 增 量 式 更 新 的 数据 对 象 


要 实现 增 量 式 更 新 , 通常 需要 建立 一 个 数据 结构 ， 从 而 浑然 一 体 地 容纳 增 量 式 。 在 我 们 的 例 
子 中 ， 这 意味 着 不 能 只 从 getMessages 或 getMessagesSince 方 法 返回 一 个 ChatMessages 列 表 ， 
还 需要 返回 消息 列表 和 时 间 戳 。 因 此 需要 创建 一 个 新 的 对 象 类 型 ， 封 装 这 两 个 内 容 。 该 对 象 不 必 
是 一 个 持久 性 对 象 ,因为 永远 不 会 将 其 存储 在 数据 仓库 中 , 它 只 需 动 态 生 成 以 响应 客户 端 请 求 即 
可 。 但 它 确实 需要 通过 网 络 进行 发 送 , 因此 , 它 需 要 被 序列 化 ( serializable ), 这 也 就 意味 着 GWT 
生成 的 代码 既 可 将 对 象 转换 为 可 以 在 消息 中 发 送 的 格式 ， 也 可 以 将 消息 转换 为 对 象 。 在 GWT 中 ， 
我 们 通过 为 对 象 实现 接口 TsSerializab1e 将 其 序列 化 。 该 接口 没有 方法 ， 它 只 是 一 个 标识 ， 用 
来 告诉 GWT 需 要 生成 序列 化 该 对 象 的 代码 。” 

了 解 上 述 内 容 之 后 ， 写 一 个 序列 化 对 象 非常 容易 ， 只 要 使 其 声明 并 实现 IsSerializable， 
然后 确保 它 包 含 一 个 默认 的 无 参数 的 构造 函数 就 可 以 了 。 因 此, 我 们 的 序列 化 对 象 简单 地 封装 了 
ChatMessages 列 表 和 一 个 将 用 作 时 间 戳 的 日 期 对 象 。 我 们 希望 GWT 对 此 进行 转换 。 实 现 该 功能 
的 最 简单 的 办 法 ， 就 是 把 它 放 在 client 软 件 包 中 。 



















































































workspace/Chat/src/com/pragprog/aebook/chat/client/ChatMessageList.java 


public class ChatMessageList implements IsSerializable { 


private List<ChatMessage> messages ; 
private long time; 
private String chat; 


public ChatMessageList(CString chat, long time) { 
this.chat = chat; 
this.time = time; 
this.messages = new ArrayList<ChatMessage>(); 


} 





@ 我 们 实际 上 可 以 为 此 使 用 标准 的 Java 接 口 Serializable。 但 是 , Serializable 被 Java 虚 拟 机 用 来 识别 哪些 是 可 以 
使 用 本 地 Java 序 列 化 机 制 序列 化 的 内 容 。GWT 不 使 用 Java 序 列 化 其 实 ，GWT 序 列 化 甚至 不 重 构 标准 的 Java 序 
列 化 。 因 此 ， 我 倾向 于 使 用 GWT 自 身 的 标识 接口 ， 使 其 清晰 地 表明 我 在 使 用 GWT 序 列 化 。 
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12.2.2 


b 


/** 

*# GWT 序列 化 的 默认 霖 参数 构造 溃 数 

*/ 

public ChatMessageList() { 
messages = new ArrayList<ChatMessage>(); 
time = System.CurrentTimeMi11is() ; 
chat = null; 


} 


public String getChat() { 
return chat; 


} 


public List<ChatMessage> getMessages() { 
return messages; 


} 


public long getTimestamp() { 
return time; 


} 


public void addMessage(ChatMessage msg) { 
messages.add(msg); 


} 
public void addMessages(List<ChatMessage> messages) { 


messages.addAll (messages); 


} 


增 量 式 的 聊天 室 界 面 





为 了 使 用 这 种 基于 时 间 的 增 量 式 取 回 机 制 , 我 们 需要 修改 一 些 旧 方法 , 并 且 在 界面 中 添加 一 
新 方法 : 





workspace/Chat/src/com/pragprog/aebook/chat/client/ChatService.java 


0 
@ 
@ 


void postMessage(ChatMessage messages); 
ChatMessageList getMessages(String room); 
ChatMessageList getMessagesSince(String chat, long timestamp); 




















@ 最 初 的 PostMessage 方 法 是 返回 一 个 聊天 室 的 消息 列表 。 但 是 ,我 们 想 要 添加 一 个 方法 








来 获得 特定 时 间 点 后 的 消息 ( 即 ， 不 想 一 遍 又 一 遍地 发 送 相同 的 旧 消 息 )， 适 用 于 
PostMessage 方 法 的 返回 结果 ， 也 适用 于 getMessages 的 返回 结果 。 我 们 有 两 种 选择 : 
可 以 给 PostMessage 添 加 一 个 时 间 玲 参数， 或 者 可 以 使 PostMessage 不 返回 值 ， 相 反 ， 
使 客户 端 在 新 消息 发 布 后 调用 getMessages。 

作为 一 般 性 的 规则 ， 最 好 是 将 查询 方法 〈 取 回 值 的 方法 ) 和 更 新 方法 ( 修改 值 的 方法 ) 
分 离开 。 我 们 将 遵循 这 一 规则 ， 使 PostMessage 的 返回 值 为 空 。 
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@ 当 用 户 第 一 次 连接 到 聊天 室 时 ， 客 户 端 应 该 获取 该 聊天 室 的 所 有 消息 。 之 后 ， 它 将 开始 做 
增 量 式 获取 。 为 了 使 这 种 方式 能 够 工作 ， 客 户 端 需要 知道 它们 第 一 次 获取 操作 的 服务 器 时 
间 。 因 此 ,我 们 必须 修改 getMessages 调 用 的 返回 类 型 ， 使 它 返回 一 个 ChatMessageList。 

目 现在 ， 我 们 终于 有 了 一 个 新 方法 : getMessagesSince。 

像 以 往 针对 GWT 的 实现 一 样 ， 我 们 需要 提供 一 个 异步 版 本 : CC 











workspace/Chat/src/com/pragprog/aebook/chat/client/ChatServiceAsync.java 
void postMessage(ChatMessage message， 


AsyncCallback<Void> callback); 


void getMessages(String chatroom, 
AsyncCallback<ChatMessageList> callback); 


void getMessagesSince(String chat, long timestamp, 
AsyncCallback<ChatMessageList> callback); 


12.2.3 ”解决 时 间 难 题 


在 云 中 ， 基 于 时 间 的 工作 确实 需要 用 点 技巧 。 客 户 端 不 是 在 同一 台 服 务 器 上 运行 。 事实 上 ， 
服务 器 并 不 是 只 有 一 个 , 因为 服务 器 端 代码 可 能 会 在 云 中 许多 不 同 的 机 器 上 运行 , 所 以 无 法 保证 
客户 端 所 使 用 的 时 钟 和 服务 器 端 是 同步 的 。 也 就 是 说 , 客户 端 上 次 取 回 消息 的 时 间 可 能 与 服务 咒 
端 认为 客户 端 取 回 消息 的 时 间 不 同 。 更 糟 的 是 , 网 络 还 可 能 会 出 现 各 种 问题 , 从 而 导致 延 时 增加 ， 
使 得 基于 时 间 的 工作 更 加 复杂 。 这 是 一 个 潜在 的 严重 问题 一 幸运 的 是 , 只 要 开发 者 清楚 问题 的 
关键 ， 也 就 不 太 难 解决 。 首 先 让 我 们 分 析 一 下 问题 。 

假设 客户 端 和 服务 器 端的 时 钟 完 全 同步 。 由 于 网 络 延 迟 所 造成 的 简单 计时 问题 , 我们 仍然 可 
能 遇 到 冲突 。 想 象 一 下 这 样 的 情景 : 

09:34:58.1432 客户 端 发 送 消息 请 求 ; 

09:23:58.1894 由 于 网 络 传输 时 间 ， 服 务 器 端 在 略微 延 时 后 收 到 该 请 求 ; 

09:23:59.2401 服务 器 端 处 理 请 求 ， 并 进行 响应 ; 

09:24:59.4019 客户 端 通过 网 络 接收 响应 。 

客户 端 应 该 使 用 哪个 时 间作 为 其 请 求 的 时 间 呢 ? 假设 客户 端 用 时 间 58.1432 作 为 发 送 请 求 的 
时 间 。 另 一 个 客户 端 可 能 已 经 在 58.1434 发 送 了 消息 X。 当 服务 器 端 收 到 请 求 时 ,会 返回 一 个 包含 
X 的 列表 。 下 一 次 客户 端 请 求 消 息 时 , 它 会 请 求 比 $8.1432 更 新 的 消息 。 由 于 X 的 时 间 戳 是 $8.1434 ， 
它 比 58.1432 新 , 因此 服务 器 端 将 再 次 在 其 响应 中 包括 消息 X。 这 意味 着 第 一 个 客户 端 将 看 到 消息 
X 两 次 。 这 显然 不 是 我 们 想 要 的 。 

我 们 还 可 以 使 用 客户 端 收 到 响应 的 时 间 : 59.4019。 也 许 另 一 个 客户 端 在 59.2530 发 送 消 息 Y。 
那么 ， 消 息 Y 将 不 会 出 现在 客户 端 收 到 的 消息 列表 中 ， 因 为 它 是 在 服务 需 端 给 客户 端 发 送 响应 后 
才 被 发 布 的 。 客 户 端 的 下 一 个 请 求 将 针对 发 布 在 59.4019 后 的 消息 ， 因 为 Y 的 时 间 惟 是 $59.2330， 这 
意味 着 它 将 不 被 包括 在 内 。 消 息 Y 将 永远 不 会 被 发 送 到 客户 端 。 同 样 , 这 显然 也 不 是 我 们 想 要 的 。 
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看 起 来 不 管 我 们 选择 哪个 时 间 , 都 会 丢失 消息 。 在 一 般 情 况 下 , 解决 的 办 法 是 使 用 单一 时 钟 。 
在 云 应 用 程序 中 ， 任 何 依赖 于 两 个 不 同时 钟 的 内 容 ， 都 是 有 问题 的 ， 必 须 始 终 以 一 个 时 钟 工作 。 
我 们 不 能 以 客户 端的 时 钟 工作 ， 因 为 客户 端的 时 钟 不 在 我 们 的 可 控 范 围 之 内 : 会 有 多 个 客户 端 ， 
并 且 没 办 法 知道 它们 是 否 同步 。 但 是 ,我 们 可 以 依赖 App Engine 服 务 器 中 的 时 钟 ， 它 们 使 用 网 络 
时 间 协 议 同步 。 可 以 肯定 的 是 ， 它 们 之 间 的 时 钟 差异 比 我 们 可 以 测量 的 时 间 单 元 要 更 小 。 

服务 器 时 钟 ， 即 服务 器 代码 中 由 App Engine 提 供 的 时 钟 ， 才 是 我 们 应 该 使 用 的 唯一 时 钟 。 这 
意味 着 当 请 求 被 送 达 时 ， 需 要 告诉 客户 端 服务 器 上 是 什么 时 间 。 









































12.2.4 实现 服务 器 端的 方法 


既然 已 经 制定 了 客户 端 和 服务 需 端 之 间 的 接口 , 接 下 来 就 来 实现 服务 器 端 代码 。 之 前 已 经 实 
现 了 其 中 的 某 些 部 分 , 但 我 们 已 经 改变 了 其 内 容 ， 并 增加 了 更 多 的 方法 ， 因 此 在 服务 器 端 ， 我 们 
几乎 要 从 零 开 始 。 

可 以 从 getMessages 开 始 入 手 。 其 代码 几乎 和 以 前 一 样 ,只 是 现在 需要 把 结果 封装 在 带 有 时 
间 惟 的 MessageList 对 象 里 。 


























workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


@SuppressWarnings ("unchecked") 
public ChatMessageList getMessages(String chat) { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try { 
Query query = persister.newQuery(CPChatMessage.class) ; 
query.setFilter("chat == desiredRoom"); 
query.declareParameters("String desiredRoom"); 
query.setOrdering("date"); 
List<PChatMessage> messages = (List<PChatMessage>)query.execute(chat); 
// 获取 最 新 消息 
ChatMessageList result = null; 
if (messages.size() > 1) { 
0 PChatMessage lastMessage = messages.get(messages.size() - 1); 
result = new ChatMessagelList(chat, lastMessage.getDate()); 
for (PChatMessage pchatmsg : messages) { 
result.addMessage(pchatmsg.asChatMessage()); 


} 
} else { 
result = new ChatMessagelist(chat, System.currentTimeMil11is()); 
} 
return result; 
} finally { 
persister.close() ; 
} 
} 
这 段 代 码 中 有 一 个 有 趣 的 片段 , 与 12.2.3 的 内 容 有 关 。 在 1 处 ,我们 得 到 了 查询 语句 返回 的 最 后 一 
条 消息 ,并 使 用 其 时 间 戳 作为 时 间 。 我 们 这 样 做 ， 而 不 采用 系统 时 间 的 原因 是 ,应 用 程序 不 是 在 


一 台 服 务 器 上 运行 的 。 但 是 ， 有 可 能 云 中 的 一 台 服 务 器 在 处 理 一 个 POST 请 求 的 同时 ， 也 在 处 理 
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一 个 GET 请 求 ， 而 且 可 能 在 查询 语句 结束 时 和 getMessages 方 法 实现 时 的 时 间 之 间 引 发 新 的 消息 
发 布 。 因此 , 可 能 有 一 个 消息 的 时 间 截 是 在 上 一 条 取 回 的 消息 和 getMessages 记 录 的 当前 时 间 之 
间 。 为 了 避免 这 种 情形 ， 我 们 只 采用 上 一 条 消息 的 时 间 。 该 策略 为 我 们 提供 了 一 致 的 时 间 视 角 ， 
以 便 增 量 式 消 息 取 回 可 以 正常 工作 。 

接 下 来 ,我 们 可 以 看 看 如 何 发 布 一 条 消息 。 从 这 里 开始 ， 事 情 开始 真 的 变 得 有 趣 了 。 

















workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


@SuppressWarnings ("unchecked") 
public void postMessage(ChatMessage message) { 

UserService userService = UserServiceFactory.getUserService(); 

User user = userService.getCurrentUserQ; 

PersistenceManager persister = Persister.getPersistenceManager(); 
try { 

PChatMessage pmessage = new PChatMessage(user.getNickname(), 
message.getMessage(), 
message.getChat()); 

0 long timestamp = System.currentTimeMi11is() ; 
pmessage.setDate(timestamp); 
persister.makePersistent(pmessage); 


© Query query = persister.newQuery(PChatRoom.class); 
query.setFilter("name == " + message.getChat()); 
List<PChatRoom> chats = (List<PChatRoom>) query.execute(); 


© PChatRoom chat = chats.get(0); 
@ chat.updateLastMessageDate(timestamp); 
} finally { 
persister.close(); 
} 
} 


我 们 从 App Engine 的 一 些 典 型 样板 开始 : 创建 一 个 PersistenceManager， 使 聊天 信息 对 象 持久 
化 ， 从 而 使 该 对 象 能 够 在 数据 仓库 中 存储 。 然 后 来 看 看 新 内 容 ， 如 下 所 述 。 
QO 修改 消息 的 日 期 。 正 如 我 前 面 所 解释 的 ， 必 须 非 党 谨慎 ， 只 使 用 一 个 时 钟 ， 也 就 是 App 
Engine 的 时 钟 。 我 们 不 考虑 客户 端的 日 期 和 时 间 ， 需 要 用 的 是 服务 器 上 的 日 斯 和 时 间 。 
@ Chat 对 象 必须 包含 上 一 条 发 布 消息 的 时 间 稚 。 因 此 ， 我 们 需要 取 回 聊天 对 象 ， 将 其 上 一 
条 消息 的 时 间 更 新 为 该 消息 的 时 间 。 
目 查询 语句 返回 聊天 室 列表 ， 但 我 们 知道 ， 该 列表 只 有 一 个 条 目 ， 因 此 ， 从 列表 中 获取 这 
个 唯一 条 目 。 
@ 现在 更 新 聊天 对 象 的 上 一 条 消息 的 日 期 。 不 需要 保存 该 消息 ， 因 为 会 使 用 
PersistenceManager 查 询 语句 取 回 该 消息 ， 所 以 ， 它 已 经 由 PersistenceManager 管 理 。 
这 意味 着 消息 的 更 新 在 事务 结束 时 会 被 自动 保存 。 
最 后 ,我们 需要 增 量 式 的 getMessagesSince: 
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workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


@SuppressWarnings ("unchecked") 
public ChatMessageList getMessagesSince(String chat, long timestamp) { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try { 
Query query = persister.newQuery(CPChatMessage.class) ; 
query.declareParameters("String desiredRoom, int earliest"); 
query.setFilter("chat == desiredRoom && date > earliest"); 
query.setOrdering("date"); 
List<PChatMessage> messages = 
(List<PChatMessage>)query.execute(chat, timestamp); 
ChatMessageList msgList = null; 
// 获取 最 新 消息 
if (messages.size() >= 1) { 
PChatMessage lastMessage = messages.get(messages.size() - 1); 
msgList = new ChatMessagelist(chat, lastMessage.getDate()); 
} else { 
msgList = new ChatMessagelList(chat, System.currentTimeMi11is()); 


®Oe 


} 
for (PChatMessage msg : messages) { 
msgList.addMessage(msg.asChatMessage()); 

站 
return msgList; 

} finally { 
persister.close(); 

} 

} 


这 个 方法 几乎 与 更 新 的 getMessages 一 样 ， 除 了 JDOQL 查 询 语句 的 以 下 两 个 改变 
QO 我 们 给 查询 添加 了 一 个 新 的 参数 , 从 而 可 以 比较 传递 给 调用 的 日 a nce 
得 到 的 消息 的 日 期 。 
@ 给 过 滤 需 添加 了 一 个 新 的 子 句 以 比较 日 期 。 


12.3 ”更 新 客户 端 


现在 终于 有 了 与 客户 端 交 互 的 所 有 服务 器 端的 方法 ! 应 用 程序 也 已 经 非常 接近 可 运行 状态 。 
但 仍然 需要 对 客户 端 进 行 一 些 修改 ,使 其 知道 如 何 使 用 更 新 的 RPC 接 口 。 

这 里 要 做 的 事情 并 不 多 ， 基 本 上 ， 唯 一 要 处 理 的 问题 是 ， 更 新 代码 以 适应 RPC 服 务 里 所 作 的 
修改 。 客 户 端 不 再 获取 聊天 消息 列表 ， 现 在 获取 的 是 ChatMessageList， 而 且 现在 每 当 收 到 
ee eos 都 需要 更 新 其 存储 的 上 一 条 消息 的 时 间 , 以 便 客户 端 可 以 使 用 该 时 间 来 进 

量 式 更 新 请 求 。 我 们 需要 做 的 全 部 工作 就 是 更 新 addNewMessages 方 法 : 

























































































workspace/Chat/src/com/pragprog/aebook/chat/client/Chat.java 


protected void addNewMessages(ChatMessageList newMessages) { 
lastMessageTime = newMessages.getTimestamp() ; 
StringBuilder content = new StringBuilder() ; 
content.append(text.getText()); 
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for (ChatMessage cm : newMessages.getMessages()) { 
content.append(renderChatMessage (cm)); 


} 
text.setText(content.toString(O)); 
} 


然后 ,我 们 还 需要 更 新 创建 了 定时 更 新 的 代码 ， 以 便 它 在 其 增 量 式 更 新 请 求 中 使 用 CC 


lastMessageTime: 





// 创建 一 个 新 定时 器 
Timer elapsedTimer = new Timer() { 

public void run(C) { 

chatService.getMessagesSince(getCurrentChat(), lastMessageTime, 
new MessageListCal1back(C)) ; 

} 
}; 
// 每 500 毫 秒 更 新 定时 器 
elapsedTimer.scheduleRepeating(500) ; 


12.4 ”聊天 室 管理 


在 可 以 运行 我 们 的 聊天 应 用 程序 之 前 , 还 有 最 后 一 件 事情 要 做 。 我 们 提供 了 一 个 在 服务 器 上 
创建 聊天 室 的 方法 , 但 还 没有 为 其 实现 任何 接口 。 就 目前 而 言 , 我 们 并 不 打算 建立 一 个 新 的 用 户 
界面 元 素 用 于 添加 聊天 室 ， 而 是 将 编写 一 些 管 理 代码 (Administration Code )。 管 理 代 码 是 开发 者 
编写 的 用 以 实现 设置 、 清 除 、 初 始 化 或 监视 的 代码 。 管 理 代 码 不 是 供用 户 访问 的 代码 ， 而 是 供 我 
们 用 来 管理 系统 的 。 

很 多 时 候 , 开发 者 会 为 自己 的 管理 代码 构建 一 个 用 户 界面 。 例 如， 如 果 开 发 者 想 要 查看 有 多 
少 人 访问 聊天 系统 ， 有 多 少 消息 发 布 到 哪个 聊天 室 ， 以 及 人 们 访问 该 系统 的 频率 , 那么 很 可 能 会 
想 要 一 个 用 户 界面 。 然 后 ， 他 们 会 建立 另 一 个 GWT 用 户 界 面 来 做 管理 。 为 了 管理 各 项 工作 ， 开 
发 者 可 能 只 会 在 自己 的 浏览 器 中 加 载 管理 者 用 户 界 面 的 URL。 如 果 只 有 开发 者 去 加 载 管理 者 用 户 
界面 ， 那 么 ， 需 要 仔细 地 提供 一 些 安全 机 制 〈 后面 将 会 详细 介绍 )， 确 保 只 有 开发 者 自己 才 可 以 
访问 管理 用 户 界面 。 当 然 , 还 有 其 他 种 类 的 管理 代码 也 很 有 价值 。 例如 第 一 次 部 署 一 台 服 务 器 时 ， 
需要 初始 化 一 些 内 容 。 聊 天 应 用 程序 需要 初始 化 一 组 聊天 室 。 

问题 在 于 , 并 非 只 在 服务 器 上 运行 代码 就 能 完成 设置 。 我 们 受 限 于 App Engine 所 提供 的 接口 ， 
需要 做 自我 检测 初始 化 (self-detecting initialization )， 也 就 是 说 ,需要 插入 代码 以 检测 服务 器 端 
是 否 已 被 初始 化 ， 如 果 没 有 ， 则 调用 初始 化 方法 。 

可 以 通过 修改 getChats 实 现 初 始 化 功能 。 每 次 用 户 进 入 应 用 程序 且 在 看 到 任何 内 容 之 前 ， 
聊天 应 用 程序 会 调用 getChats 来 初始 化 聊天 室 列表 视图 。 所 以 要 做 的 工作 就 很 简单 了 。 当 应 用 
程序 取 回 聊天 室 列表 时 ,我 们 将 进行 检查 ,以 查看 列表 是 否 为 空 。 如 果 是 ， 则 调用 一 个 方法 初始 
化 一 组 聊天 室 。 我 们 将 初始 化 方法 放 在 服务 器 的 实现 中 , 但 不 会 将 其 声明 为 RPC。 我 们 不 希望 用 
户 能 够 调用 该 初始 化 方法 , 它 被 调用 的 唯一 方式 应 该 就 是 当 系 统 检 测 到 聊天 室 还 未 被 初始 化 时 自 
动 调用 。 
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初始 化 聊天 室 的 代码 非常 简单 。 我 们 创建 一 个 PersistenceManager， 创 建 一 些 聊天 室 ， 并 
将 它们 持久 化 : 


workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


static final String[] DEFAULT_ROOMS = 
new String[] { "chat", "book", "java", "python" }; 


public List<ChatRoom> initializeChats(PersistenceManager persister) { 
List<ChatRoom> rooms = new ArrayList<ChatRoom>() ; 
List<PChatRoom> prooms = new ArrayList<PChatRoom>() ; 
long now = System.currentTimeMil11is(); 
for (String name : DEFAULT_ ROOMS) { 
PChatRoom r = new PChatRoom(name, now); 
prooms.add(r); 
rooms.add(r.asChatRoom()); 
persister.makePersistent(r); 
} 
return rooms; 


} 
为 了 调用 该 方法 ， 我 们 只 需 给 getChats 增 加 一 个 测试 ， 检 查 一 下 数据 仓库 中 的 聊天 室 列表 是 
否 为 空 。 如 果 是 ,我们 调用 initializeChats: 




















workspace/Chat/src/com/pragprog/aebook/chat/server/ChatServicelmpl.java 


@SuppressWarnings ("unchecked") 
public List<ChatRoom> getChats() { 
PersistenceManager persister = Persister.getPersistenceManager() ; 
try { 
Query query = persister.newQuery(CPChatRoom.class) ; 
query.setOrdering("date"); 
List<PChatRoom> rooms = (List<PChatRoom>)query .execute(); 
if (rooms.isEmpty()) { 
return initializeChats(persister); 
} elsef{ 
List<ChatRoom> result = new ArrayList<ChatRoom>(); 
for (PChatRoom pchatroom : rooms) { 
result.add(pchatroom.asChatRoom()); 


} 
return result; 
} 
} 
finally { 
persister.close(); 
} 
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12.5 ”运行 和 部 署 聊天 应 用 程序 


我 们 终于 完成 了 Java 版 本 的 聊天 室 ! 现在 该 测试 它 了 。 在 Eclipse 中 ， 开 发 者 只 要 使 用 “运行 ” 
( Run ) 按钮 就 可 以 运行 其 应 用 程序 。 应 用 程序 启动 需要 几 分 钟 , 然后 会 tea 
测试 服务 器 的 URL。 开 发 者 访问 该 URL 时 ,就 会 被 要 求 安装 一 个 浏览 絮 插 件 : 为 了 测试 目的 ， 
使 用 一 种 特殊 的 机 制 来 管理 客户 端 和 服务 器 端 之 间 的 通信 , 以 便 开发 者 可 De eae 
踪 客 户 端 和 服务 器 端 两 端的 工作 。( 事实 上 ， 开 发 者 甚至 可 以 跟踪 RPC， 从 RPC 在 客户 端 被 调用 
的 地 方 到 其 真正 在 服务 器 上 被 执行 。 ) Eclipse 使 App Engine 程 序 的 调试 与 传统 的 应 用 程序 调试 几 
平一 样 简 单 。 

在 开发 者 可 以 将 其 Java 代 码 部 署 到 App Engine 服 务 器 之 前 ， 需 要 进行 一 个 完整 的 GWT 编 译 。 
还 是 靠 Eclipse 使 事情 变 得 很 简单 ,首先 , 开发 者 需要 进行 一 个 全 面 GWT 编 译 。 通 常情 况 下 , Eclipse 
做 的 是 部 分 编译 ， 基 本 上 只 使 用 受 限 模式 的 Java 编 译 器 。 然 而 ， 为 了 部 署 应 用 程序 ， 开 发 者 需要 
ee 实现 Java 到 JavaScript 的 完全 转换 。Eclipse 工 具 栏 的 上 方 ， 有 一 个 看 起 来 像 红色 工 

箱 的 按钮 ， 标 有 Google 的 “G:”， 只 要 按 一 下 该 按钮 ，Eclipse 就 会 做 全 面 GWT 编 译 。 

现在 , 我 们 的 应 用 程序 终于 可 以 运行 了 ! 紧邻 着 刚才 用 来 编译 应 用 程序 的 工具 栏 按钮 ， 有 一 
个 看 起 来 像 App Engine 喷 气 发 动机 标志 的 按钮 。 请 点 击 该 按钮 。 开 发 者 第 一 次 点 击 该 按钮 时 ， 它 
会 提示 开发 者 输入 App Engine 应 用 程序 的 ID ， 然 后 它 会 进行 部 署 。 做 一 次 完整 部 署 需要 花费 几 分 
钟 ， 但 是 ， 一 旦 完成 ， 开 发 者 的 应 用 程序 就 在 App Engine 中 “居住 ”下 来 了 。 

那么 ， 完 成 所 有 这 些 工作 之 后 ， 应 用 程序 看 起 来 是 什么 样子 呢 ? 请 将 视线 移动 到 下 面 的 图 
12-1 上 。 
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图 12-1 已 部 署 的 Java 版 聊天 室 

















很 漂亮 ， 是 吧 ? 
就 像 Python 应 用 程序 一 样 ， 开 发 者 现在 拥有 应 用 程序 控制 面板 上 所 有 管理 控制 的 访问 权 。 


故障 排除 
当 开 发 者 部 署 应 用 程序 时 ， 有 几 个 问题 经 常 发 生 ,但 是 旺 消 息 看 起 来 怪异 和 神秘 ， 并 
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且 ， 在 最 坏 的 情况 下 ， 极 具 误导 性 。 这 里 有 两 个 最 常见 的 怪异 错误 ， 如 下 所 述 。 

口 当 开 发 者 改变 在 数据 仓库 存储 数据 的 方式 时 ， 经 常会 得 到 各 种 奇怪 的 错误 消息 ， 例 如 ， 

类 强制 转换 异常 和 “无 法 转换 数据 类 型 ”。 这 两 个 错误 信息 是 由 于 开发 者 的 数据 仓库 包含 
了 修改 存储 方式 之 前 的 数据 所 造成 的 ， 导 致 了 数据 仓库 中 的 数据 不 一 致 。 因 此 ， 开 发 者 
最 好 在 部 署 应 用 程序 之 前 确定 好 数据 结构 。 但 是 ， 在 工作 过 程 中 ， 当 确定 数据 结构 时 ， 
开发 者 会 经 常 需 要 改变 内 容 。 例 如 ， 当 我 调整 本 章 的 代码 时 ， 最 初 将 数据 存储 为 一 个 
java.uti1.Date 的 对 象 , 但 后 来 发 现 该 对 象 竞 然 引 发 了 一 个 GWT 的 RPC 问 题 , 所 以 我 将 
时 间 戳 的 表示 改 为 1ong 型 ， 用 来 指明 从 某 个 时 间 点 开始 的 、 以 毫秒 计 的 时 间 戳 。 
这 些 错误 并 不 是 由 开发 者 代码 中 的 任何 问题 引起 的 ， 完 全 是 由 留 在 开发 者 的 本 地 数据 仓 
库 的 旧 数 据 造成 的 。 要 修正 这 样 的 错误 ， 需 要 做 的 就 是 请 空 本 地 数据 仓库 的 旧 数 据 。 为 
此 ， 开 发 者 只 需要 删除 其 Java 项 目 中 WEB-INF/appengine-generated/1local_db.bin 日 
录 中 的 内 容 。 如 果 已 经 实际 部 署 了 应 用 程序 , 那么 就 需要 去 应 用 程序 的 仪表 板 , 选择 “ 数 
据 仓 库 视 图 ”( Datastore Viewer )， 在 那里 ， 可 以 进行 “全 部 选择 ”( Select All )， 然 后 删除 
所 有 需要 清除 的 对 象 。 

口 JavaApp Engine 最 神秘 的 ,但 又 最 常见 的 错误 之 一 出 现在 GWT RPC 人 参数 中 。 当 开发 者 运 
行 其 应 用 程序 时 ， 会 得 到 错误 消息 :“ 类 型 ( type ) 不 包括 在 能 够 被 此 序列 化 策略 
( Serialization-Policy ) 序列 化 的 类 型 组 中 。” 这 似乎 是 暗示 配置 有 问题 ， 但 该 错误 非常 具 
有 误导 性 。 发 生 错 误 的 原因 只 是 开发 者 在 该 类 型 中 遗漏 了 一 个 零 参 数 的 构造 函数 。GWT 
使 用 的 每 一 个 序列 化 的 类 型 都 必须 有 一 个 公共 的 、 零 参数 的 构造 方法 。 它 并 不 需要 做 任 
何 实际 的 初始 化 ， 它 只 是 被 GWT 基 础 架构 用 来 创建 一 个 空白 的 对 象 ， 然 后 GWT 会 用 反 序 
列 化 消息 的 结果 填充 该 对 象 。 


12.6 服务 器 端 结束 语 


过 去 的 几 章 介绍 了 大 量 内 容 。 我 们 已 经 看 到 了 如 何在 Java 中 实现 数据 仓库 持久 性 ， 学 到 了 很 
多 GWT 的 有 关 知 识 ， 了 解 了 如 何 使 用 GWT 的 模型 设计 应 用 程序 。 关 于 如 何 构建 一 个 基于 RPC 的 
客户 端 和 服务 器 端 之 间 的 接口 , 以 及 如 何 使 用 该 接口 生成 性 能 良好 的 网 络 应 用 程序 方面 , 我 们 做 
了 很 多 工作 。 

从 这 里 开始 ， 将 要 切换 到 更 高 级 的 主题 。 我 们 不 再 特别 专注 于 Java 或 Python ， 而 是 去 了 解 一 
些 不 同 的 主题 : 安全 和 认证 、 高 级 数据 管理 、 管 理 和 实施 ， 以 及 监控 。 对 于 每 一 个 主题 ,我 们 都 
将 会 讲解 如 何在 Java 和 Python 中 实现 。 
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我 们 在 学 习 Google App Engine 编 程 时 , 已 经 使 用 数据 仓库 完成 了 一 些 基 本 的 工作 。 虽然 我 们 
没有 做 什么 特别 困难 的 事情 , 但 是 ， 即 使 是 在 已 经 实现 的 简单 的 应 用 程序 中 , 数据 仓库 也 是 我 们 
设计 的 核心 。 当 开发 人 员 开 始 构建 更 加 复杂 的 App Engine 程 序 时 ， 就 会 发 现 ， 数 据 仓 库 变 得 更 加 
重要 了 。 

数据 仓库 能 够 做 的 事情 远 远 多 于 我 们 到 目前 为 止 所 看 到 的 功能 。 它 是 一 个 非常 强大 、 非 常 灵 
活 的 持久 性 存储 系统 。 在 本 章 中 ， 我 们 将 了 解数 据 仓库 有 哪些 能 力 ， 并 试验 它 的 一 些 高 级 功能 。 

从 本 音 开 始 将 采取 一 种 不 同 的 方法 。 我 们 不 会 把 自己 局 限于 Java 或 Python， 而 是 要 同时 考虑 
二 者 。 我 们 也 不 去 构建 用 户 界面 ， 而 是 将 重点 放 在 数据 管理 。 我 们 将 会 看 到 ， 可 以 使 用 HTTP 为 
App Engine 应 用 程序 构建 服务 ， 该 方式 允许 我 们 使 用 任意 最 便捷 的 编程 语言 实现 每 个 服务 。 我 们 
可 以 使 用 HTTP 层 作为 编程 语言 之 间 的 桥梁 ,从 而 能 够 编写 使 用 Java 服 务 的 Python 服务 ,反之 亦 然 。 


13.1 构建 文件 系统 服务 


纵 观 高 级 主题 部 分 ， 我 们 不 再 继续 把 重点 放 在 聊天 应 用 程序 上 ， 而 将 建立 不 同 种 类 的 服务 ， 
以 展示 Google App Engine 的 各 个 部 分 。 在 这 一 章 中 ,我们 将 使 用 数据 仓库 构建 一 个 类 似 文件 系统 
的 服务 。 

我 们 可 以 认为 这 是 聊天 服务 的 附加 功能 的 基础 设施 。 许 多 聊天 系统 ( 例如 Google Talk ) 为 用 
户 提供 共享 和 交换 文件 的 能 力 。 我 们 的 文件 系统 服务 可 以 用 来 实现 聊天 应 用 程序 中 一 个 类 似 的 文 
件 系 统 。 

在 开始 在 Google App Engine 中 实现 文件 系统 服务 之 前 ， 先 需要 弄 清楚 我 们 需要 的 是 什么 。 
由 于 这 是 一 个 基于 网 络 的 文件 系统 ， 所 以 ， 它 的 行为 不 会 和 传统 操作 系统 的 本 地 磁盘 文件 系统 
完全 一 样 口 

基于 网 络 的 文件 系统 应 该 是 什么 样子 的 呢 ? 实际 上 已 经 有 一 个 实现 网 络 文件 系统 的 标准 方 
式 了 ， 基 于 一 个 称 为 WebDAV 的 HTTP 扩 展 版 本 。WebDAV 实 在 太 复杂 了 ， 难 以 作为 例子 实现 ， 
但 是 我 们 可 以 将 其 看 作 一 个 粗略 的 模型 。 在 WebDAV 中 ,每 一 个 URL 标 识 了 一 个 资源 ， 资 源 基本 
上 是 一 个 文件 。 每 个 资源 有 内 容 ， 内 容 是 字 节 、 特 性 的 集合 ， 特 性 是 从 名 称 到 元 数据 块 的 映射 。 
由 于 数据 仓库 使 用 property ( 特性 ) 作为 其 模型 的 字段 名 称 ， 我 们 将 使 用 attribute ( 属性 ) 代替 。 
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REST 风格 编程 

在 本 章 中 , 我 们 将 围绕 REST 模型 来 构建 应 用 程序 , 我 们 将 要 做 的 编程 过 程 通常 被 称 为 
REST 风格 编程 。 REST 是 Representational State transfer ( 表示 状态 转移 ) 的 简称 , 其 含义 是 : 
开发 者 所 编写 的 程序 使 用 基于 网 络 的 协议 时 就 是 按照 网 络 协 议 原先 预期 的 方式 访问 和 更 新 
网 络 上 的 资源 的 。 

REST 已 成 为 一 个 时 肾 词 一 每 个 人 都 希望 声称 他 们 的 系统 是 REST 风格 的 ， 并 且 其 技 
术 是 实现 REST 的 最 好 的 方式 。 然 而 ，REST 实际 上 并 不 复杂 。 

REST 的 含义 是 ， 开 发 者 使 用 基本 的 HTTP 原 语 (GET、PUT 和 POST ) 时 是 完全 
按照 它们 原 定 的 方式 使 用 的 。 如 果 要 取 回 数据 ,你 总 是 使 用 GET; 要 存储 一 个 完整 的 对 
象 ， 你 会 使 用 PUT; 要 更 新 数据 , 你 会 使 用 POST。 通常 , 在 REST 中 , 开发 者 不 为 GET 
或 PUT 指定 类 似 于 CGI 参数 的 内 容 : 因为 一 个 URL 标识 了 一 个 特定 的 资源 , 而 且 由 于 
GET 意味 着 “ 取 回 资源 "， 所 以 ， 开 发 者 取 回 资源 时 只 需 用 到 URL， 应 该 不 需要 更 多 的 
其 他 内 容 。 

由 于 REST 的 简洁 性 , 它 很 强大 。 很 多 基于 网 络 的 编程 都 是 以 人 难以 置信 的 草率 的 方式 
实现 的 。 有 大 量 的 网 络 和 云 应 用 程序 在 GET 中 使 用 带 CGI 参数 的 长 长 的 字符 串 ， 以 完成 除 
了 取 回 数据 之 外 的 各 种 事情 。 在 许多 方面 ，REST 就 像 网 络 中 的 面向 对 象 : 它 是 一 种 编程 的 
方式 ， 围 绕 着 开发 者 正在 使 用 的 基本 实体 和 这 些 实 体 需要 的 基本 操作 进行 构建 。 





因此 , 例如 ， 在 传统 的 本 地 文件 系统 中 ， 用 户 会 有 元 数据 ， 如 所 有 者 、 创 建 时 间 、 访 问 权限 
等 。 而 在 我 们 的 类 似 于 WebDAV 的 文件 系统 中 ， 这 些 都 将 使 用 属性 来 处 理 。 

有 一 件 起 初 有 点 令 人 意外 的 事情 是 ,在 WebDAV 中 ， 目录 只 是 一 个 普通 的 资源 。 一 个 目录 资 
源 和 一 个 非 目 录 资 源 之 间 的 唯一 区 别 在 于 目录 有 一 个 属性 ， 该 属性 包含 了 子 资源 名 称 列表 。 

下 面 来 实现 该 文件 系统 。 首 先 ， 我 们 只 是 写 一 些 标准 的 Python 代码 ， 然 后 逐步 把 Python 代码 
转换 为 数据 仓库 版 本 。 因 此 , 我 们 将 从 用 Python 编写 的 一 个 非常 基本 的 伪 文 件 系统 的 代码 框架 开 
始 。 这 并 不 是 Google Apple Engine 代 码 ， 它 只 是 标准 的 Python 代码 ， 用 来 表述 我 们 所 硕 望 的 系统 
执行 方式 。 根 据 我 的 经 验 ， 这 往往 是 构建 Google Apple Engine 应 用 程序 或 服务 中 非常 有 价值 的 第 
一 步 。 这 一 步 意味 着 开发 者 构建 去 应 用 程序 时 , 已 经 弄 清楚 了 希望 系统 如 何 执 行 的 一 系列 传统 问 
题 ,也 理解 了 该 程序 在 基于 云 的 环境 中 执行 的 各 种 新 问题 。 做 好 第 一 个 框架 , 有 助 于 开发 者 在 开 
台 云 编程 之 前 ， 理 清 基 本 的 设计 问题 。 

































































144 第 13 章 高 级 数据 仓库 : 特性 类 型 





filesystem/filesystem.py 


from datetime import datetime 
import string 


class Resource(object): 
@staticmethod 
def MakeResource(): 
return Resource(content=None, attributes={}) 


def fs_put(self, content): 
self.content = content 


def fs_get(self): 
return self.content 


def fs_setAttribute(self, name, value): 
self.attributes[name] = value 


def fs_getAttribute(self, name): 
return self.attributes[namel] 


def isDir(Cself): 
return self.getAttribute("children") is not None 


def addChild(self, name, resource): 
if self.getAttribute("children") is None: 
self.setAttribute("children", {}) 
self.getAttribute("children")[name] = resource 


class FileSystem(object): 
@staticmethod 
def MakeFilesystem() : 
fs = FileSystem() 
fs.root = FileSystem.MakeFile("/", "root", "") 
return self 


@staticmethod 

def MakeFile(name, owner, content): 
file = Resource() 
file.put(content) 
file.setAttribute("owner", owner) 
file.setAttribute("time", datetime.now()) 
return file 


def getRoot(self): 
return self.root 


def getResourceFromChild(self, child, nameElements): 
"" "获取 文件 路 径 的 一 个 递归 处 理 函 数 。Chi1d 是 这 个 递归 调用 目标 中 的 目录 名 。nameElements 则 是 Chi1d 随 后 路 径 
名 的 各 种 组 成 部 分 。 每 次 递归 调用 者 会 取出 一 部 分 路 径 ， 然 后 在 余下 的 路 径 中 再 调用 自身 。 当 nameElements 为 空 时 ， 也 就 获取 
到 了 整个 路 径 。""" 
if nameElements is []: 
return child 
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childsChildren = child.getAttribute("children") 
if childsChildren is None: 
return None 
else: 
nextChild = childsChildren[nameElements[0]] 
if nextChild is None: 
return None 
else: 
return self.getResourceFromChild(nextChild, nameElements[1:]) 


def getResourceAtPath(self, path): 
pathElements = string.split(path, "/") 
self.getResourceFromChild(self.getRoot(), pathElements) 


上 面 的 代码 非常 简单 ， 所 以 我 并 不 打算 深入 解释 。 文 件 系统 就 是 一 个 对 象 ， 有 一 个 根 目 录 。 目 录 
仅仅 是 一 个 资源 ， 有 一 个 名 为 chi1dren 的 属性 ， 该 属性 是 从 名 称 到 资源 的 映射 。 文 件 系 统 要 实 
现 解析 复杂 路 径 得 到 资源 的 方法 。 


13.2 ” 浅 党 文件 系统 建 模 


看 一 下 上 边 的 非 数据 仓库 版 本 的 文件 系统 , 让 我 们 想 想 如 何 将 其 转化 成 数据 仓库 的 持久 性 版 
本 。 该 文件 系统 确实 简单 ， 它 是 一 个 持久 性 对 象 ， 具有 一 个 特性 一 一 根 资源 。 文 件 系统 对 象 最 终 
将 成 为 一 个 与 servlet 相 关 的 对 象 ， 所 有 访问 该 文件 系统 中 的 任何 内 容 的 调用 都 将 通过 与 该 文件 系 
统 对 象 相关 联 的 单一 的 servlet 处 理 。 但 现在 ， 我 们 不 去 担心 这 一 部 分 内 容 ， 只 是 创建 一 个 文件 系 
统 模型 。 我 们 暂 不 实现 各 个 方法 (如 getResourceFromChi1d )。 在 实现 方法 之 前 ， 首 先 需 要 理 
解 我 们 的 文件 系统 是 如 何 表示 的 。 









































filesystem/persistent_filesystem.py 


class FileSystem(object): 
def __init__(self): 
self.root = MakeFile("/", "root", "") 
return self 
def getRoot(self): 
return self.root 


def getResourceFromChild(self, child, nameElements): 
if nameElements is []: 
return child 
childsChildren = child.getProperty("children") 
if childsChildren is None: 
return None 
else: 
nextChild = childsChildren[nameElements[0]] 
if nextChild is None: 
return None 
else: 
return getResourceFromChild(nextChild, nameElements[1:]) 
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def getResourceAtPath(self, path): 
pathElements = string.split(path, "/") 


资源 也 更 为 有 趣 。 资 源 有 两 个 特性 : 内 容 和 属性 。 很 明显 ， 内 容 是 一 个 大 文件 一 一 一 个 巨大 
的 字 节 组 。 我 们 不 知道 ， 也 不 关心 除 此 之 外 内 容 是 否 有 结构 体 。 

但 是 ,如何 表 示 资 源 的 属性 是 个 麻烦 。 属 性 是 从 名 称 到 值 的 映射 ， 而 值 可 以 是 任何 东西 ! 到 
目前 为 止 ， 我 们 已 经 看 到 的 Python 持久 性 需要 为 持久 化 特性 声明 一 个 类 型 ， 但 是 ， 除 了 在 原始 
Python 中 处 理 属性 的 方式 之 外 ,没有 一 种 单一 类 型 的 值 可 以 被 所 有 属性 使 用 。 因 此 ， 我们 在 数据 
仓库 中 不 能 采用 这 种 方式 。 

有 两 种 方法 可 以 解决 这 个 问题 。 或 者 用 一 种 方法 将 属性 描述 为 能 在 数据 仓库 中 声明 的 可 储 
存 对 象 ， 或 者 找到 一 些 更 灵活 地 存储 东西 的 方式 。 现 在 ,我 们 将 尝试 前 者 ， 要 求 所 有 的 属性 值 
必须 是 字符 串 。 如 果 用 户 要 使 用 更 复杂 的 类 型 作为 属性 值 ， 可 以 ,但 是 当 用 户 要 在 资源 对 象 中 
存储 该 属性 时 ， 需 要 将 其 转换 成 字符 串 形式 。 这 样 做 并 不 会 过 于 繁琐 ,因为 要 在 消息 中 使 用 这 
些 内 容 ， 用 户 必须 通过 某 种 方式 将 对 象 转换 为 wire 格 式 ， 如 XML 或 JSON 等 ,而 且 可 以 只 使 用 这 
种 表示 方式 。 

当然 , 这 并 没有 完全 解决 我 们 的 问题 。 用 目前 已 经 看 到 的 数据 仓库 模型 ,我 们 只 能 使 用 原子 
特性 值 一 一 也 就 是 说 ， 不 能 存储 列表 或 映射 。 

笠 运 的 是 ,这 不 是 一 个 真正 的 数据 仓库 的 限制 ， 只 是 目前 为 止 看 到 的 功能 设置 的 限制 。 数 据 
仓库 不 支持 映射 ,但 它 支 持 列表 ,虽然 得 在 感 兴趣 的 值 的 列表 部 分 做 一 些 工作 。 后 边 会 看 到 ,在 
查询 语句 的 帮助 下 ， 数 据 仓库 能 够 做 得 足够 好 。 

但 现在 ， 因 为 不 能 使 用 映射 ， 所 以 我 们 将 使 用 列表 来 构建 映射 。 数 据 仓库 的 模型 支持 列表 。 
列表 有 一 些 限 制 , 但 是 可 以 完成 这 项 工作 。 列 表 包 括 的 值 要 具有 相同 的 类 型 。 而 不 管 是 Python 原 
始 对 象 还 是 数据 仓库 关键 字 都 需要 这 些 值 。 

在 数据 仓库 中 ， 每 个 存储 的 对 象 都 有 一 个 唯一 的 关键 字 。 给 定 该 关键 字 ， 用 户 可 以 取 回 和 更 新 
相应 的 对 象 。 因 此 ， 对 于 属性 ， 我 们 将 使 用 一 个 关键 字 / 值 的 二 元 组 列表 。 关 键 字 和 值 都 是 字符 串 。 
因此 ， 要 取 回 资源 的 一 个 属性 ， 首 先 搜索 资源 的 属性 列表 ， 如 果 找 到 所 需 的 属性 ， 则 返回 属性 值 。 

综 上 ， 我 们 需要 做 的 第 一 件 事 情 是 创建 一 个 属性 类 型 

































































































































































filesystem/first-persistent.py 


class ResourceAttribute(db.Model): 
name = db.StringProperty(required=True) 
value = db.TextProperty(required=True) 


属性 是 一 种 有 着 以 下 两 个 字段 的 对 象 。 

D name 

字符 串 特 性 。 字 符 串 不 能 超过 500 个 字符 , 但 是 , 我 们 可 以 编写 使 用 字符 串 值 的 查询 语句 ， 
并 且 可 以 按照 字符 串 特 性 对 查询 结果 排序 。 我 们 可 能 希望 能 够 做 类 似 于 “所 有 上 有 具有 
children 特 性 的 对 象 ”的 查询 ， 从 而 取 回 所 有 目录 ， 因 此 ， 需 要 使 用 字符 串 特 性 来 表示 


name 字 有 段 。 
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口 value 
对 于 值 ， 我 们 将 使 用 文本 特性 。 文 本 虽然 可 以 是 我 们 想 要 的 任意 长 度 ， 但 是 使 用 文本 的 
方式 比 字 符 串 更 为 受 限 。 这 里 要 做 一 个 权衡 。 一 方面 ， 我 们 可 能 希望 能 够 做 一 些 工作 ， 
如 编写 获得 特定 用 户 创建 的 所 有 资源 的 查询 ， 而 要 实现 这 样 的 查询 ， 需 要 能 够 在 查询 中 
使 用 特性 的 值 。 但 男 一 方面 ， 我 们 不 知道 用 户 可 能 想 要 在 特性 中 存储 什么 类 型 的 数据 ， 
而 且 不 难 想象 ， 有 时 候 用 户 会 希望 他 们 的 特性 长 于 500 个 字符 。 因 此 ， 至 少 现在 ， 我 们 会 
倾向 于 使 用 较 大 特性 值 。 

这 样 ,我 们 可 以 创建 文件 系统 资源 模型 的 第 一 个 版 本 。 模 型 的 基本 结构 如 下 所 示 , 该 代码 中 

尚 没有 实现 其 行为 的 方法 : 





























filesystem/first-persistent.py 


class PersistentResource(db.Model): 


content = db.BlobProperty(default = "") 

0 attributes = db.ListProperty(item type=db.Key) 
@staticmethod 

© def MakeResource(creator): 


resource = PersistentResource() 

resource.content = "" 

attribute = ResourceAttribute(name="creator", value=creator) 
© attribute.put() 
@ resource.attributes.append(attribute.keyQO) 

resource.put() 


@ 资源 属性 的 列表 特性 非常 简单 。 因 为 我 们 定义 了 一 个 数据 仓库 知道 如 何 持久 性 保存 的 属 
性 类 型 ， 所 以 可 以 为 对 象 创建 一 个 关键 字 列 表 。 因 此 ， 只 需 定 义 列 表 特 性 作为 数据 仓库 
关键 字 列表 。 就 这 么 简单 。 

@ 为 数据 仓库 的 持久 性 类 型 提供 标准 的 Python 的 _init 方法 是 一 个 非常 糟糕 的 主意 : 数 
据 仓库 的 实现 提供 了 一 个 默认 的 初始 化 过 程 , 正 是 因为 用 户 无 法 改变 数据 仓库 内 部 行为 ， 
所 以 才 保 证 了 它 的 正确 性 。 因 此 ,我 们 使 用 静态 方法 构建 内 容 。 在 静态 MakeResource 方 
法 中 ， 创 建 一 个 资源 的 空 实 例 ， 然 后 填充 几 个 字段 。 创 建 资源 模型 的 实例 时 ， 将 初始 化 
一 个 属性 。 我 们 并 不 一 定 要 做 这 项 工作 ， 客 户 端 不 会 直接 调用 此 代码 。 它 们 只 能 通过 稍 
后 构建 的 HTTP 接 口 调用 。 但 是 为 了 说 明 此 代码 是 如 何 工 作 的 ,我 们 在 这 里 初始 化 
creator 特 性 。 

目 按照 正规 的 方式 创建 属性 ， 使 用 数据 仓库 提供 的 默认 的 构造 函数 。 然 后 ， 告 诉 数据 仓库 
存储 该 属性 对 象 。 这 样 做 是 有 原因 的 。 首 先 ， 属 性 不 包含 在 资源 对 象 中 ， 因 此 存储 资源 
时 ， 不 会 存储 属性 对 象 ， 只 会 存储 一 个 对 属性 对 象 的 关键 字 引 用 。 因 此 ， 属 性 需要 被 存 
储 。 我 们 需要 在 存储 资源 前 存储 属性 ， 这 是 因为 要 将 属性 放 到 资源 的 属性 列表 中 ， 需 要 

使 用 它 的 关键 字 ， 而 关键 字 直 到 对 象 存储 时 才 会 被 初始 化 。 因 而 ， 创 建 出 属性 ， 并 先 将 

其 放 到 数据 仓库 中 。 
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@ 有 了 存储 的 属性 ， 现 在 可 以 访问 其 关键 字 了 。 要 设置 资源 的 属性 ， 只 要 在 属性 列表 中 添 
加 属性 对 象 的 关键 字 就 可 以 。 然 后 ， 我 们 存储 该 资源 ， 所 有 的 事情 就 都 做 好 了 。 
现在 ， 我 们 有 了 恰当 的 模型 ， 需 要 看 看 如 何 实现 它们 的 行为 。 基 本 的 内 容 的 get 和 put 简 单 
易 懂 : 




















filesystem/first-persistent.py 
def GetContent(self): 


return self.content 


def PutContent(self, content): 
self.content = content 
self.putO) 


根本 不 用 任何 解释 ,应 该 很 清楚 ! 现在 ,可 以 把 重点 转移 到 属性 上 。 让 我 们 先 看 看 如 何 取 回 
属性 的 值 : 











filesystem/first-persistent.py 


def GetAttribute(self, name): 
for attr_key in self.attributes: 
attr = ResourceAttribute.get(attr_key) 
if attr.name == name: 
return attr.value 
return None 


QO 资源 的 attributes 字 段 是 一 个 标准 的 Python 列表 。 该 列表 中 的 元 素 是 属性 值 的 关键 字 。 
要 找到 一 个 具有 特定 名 称 的 属性 , 我 们 需要 遍历 所 有 的 属性 。 可 以 只 用 一 个 标准 的 Python 
循环 实现 特定 名 称 的 属性 查找 。 

@ 现在 ， 在 这 个 循环 中 ,我们 要 查看 实际 的 属性 。 因 此 ， 需 要 做 的 第 一 件 事 情 是 取 回 属性 。 
当 用 户 有 关键 字 时 , 可 以 通过 调用 Classname .get(key) 取 回 属性 。 从 这 里 , 读者 就 会 明 
白 ， 为 何 即 使 用 了 关键 字 ， 也 不 能 实现 一 个 可 以 包含 不 同类 型 元 素 的 列表 。 当 用 户 通过 
关键 字 取 回 存储 的 对 象 时 ， 需 要 知道 它 的 类 型 ， 以 调用 该 关键 字 。 因 此 在 这 里 ， 由 于 我 
们 知道 关键 字 都 是 针对 ResourceAttribute 对 象 的 ,所 以 可 以 通过 调用 ResourceAttribute. 
get(attr_key) 来 取 回 对 象 。 
开发 者 可 能 会 担心 进行 一 系列 get 操 作 的 性 能 ， 因 为 每 个 属性 需要 一 个 get 操 作 。 说 真 的 ， 
其 性 能 还 不 错 。 首 先 ， 每 个 资源 属性 个 数 都 很 少 ， 在 使 用 这 种 结构 的 实际 文件 系统 中 ， 
资源 的 最 大 属性 数量 通常 是 20 个 左右 ， 大 多 数 都 比 这 少 。 这 意味 着 取 回 的 数量 非常 少 。 
此 外 ， 通 过 关键 字 取 回 真 的 很 快 ， 比 通过 查询 语句 取 回 要 快 出 很 多 。 关 键 字 取 回 和 查询 
取 回 的 具体 关系 取决 于 查询 的 复杂 性 ， 但 通常 通过 关键 字 所 做 的 很 多 次 取 回 操作 要 比 单 
个 查询 语句 的 成 本 要 低 。 

SetAttribute 的 实现 非常 相似 : 


0 
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filesystem/first-persistent.py 


def SetAttribute(self, name, value): 
for attr_key in self.attributes: 
attr = ResourceAttributeModel.get(attr_key) 


if attr.name == name: 
attr.value = value 
attr.put() 
return 
© newAttr = ResourceAttribute(name=name, value=value) 


newAttr .put() 
self.attributes.append(newAttr .key()) 
self.put() 


@ 就 像 在 getAttribute 方 法 中 一 样 ， 需 要 搜索 属性 列表 ， 找 到 要 改变 的 那个 属性 。 因 此 ， 
用 一 个 完全 类 似 于 get 中 所 做 的 循环 : 遍历 了 属性 关键 字 ， 并 对 于 每 一 个 关键 字 , 取 回 其 
属性 对 象 。 然 后 再 检查 它 的 关键 字 。 
@ 如 果 找 到 一 个 属性 ， 其 关键 字 与 要 设置 的 匹配 ， 只 要 更 新 该 属性 对 象 并 重新 存储 即 可 。 
由 于 在 原 位 更 新 值 ， 所 以 并 不 需要 担心 重新 保存 关键 字 ， 属 性 关键 字 已 经 存储 在 资源 对 
象 中 ， 而 且 并 没有 改变 它 。 一 旦 完成 更 新 ， 就 大 功 告 成 了 ， 因 此 ， 可 以 返回 。 
目 如 果 该 特性 不 存在 于 资源 中 ， 那么 将 退出 循环 而 不 必 人 返回 。 在 这 种 情况 下 ， 需 要 创建 该 
属性 ， 并 把 它 保存 到 数据 仓库 中 。 然 后 就 可 以 把 该 属性 的 关键 字 放 到 资源 的 属性 列表 中 ， 
并 且 保 存 更 新 的 资源 。 这 种 情况 下 需要 保存 资源 ， 因 为 增加 了 新 的 属性 ， 从 而 修改 了 该 
综 上 所 述 , 这 是 文件 系统 的 基本 核心 功能 ， 以 数据 仓库 可 以 使 用 的 方式 实现 。 还 需要 做 一 些 
其 他 事情 ， 比 如 说 希望 能 够 查询 一 个 给 定 的 资源 是 否 是 一 个 目录 。 按照 数 据 模型 ,目录 是 一 个 包 
含 子 属性 的 资源 。 这 种 检查 很 容易 实现 : 







































































filesystem/first-persistent.p 


def IsDir(Cself): 
return self.GetAttribute("children") is not None 


还 需要 处 理 如 给 目录 添加 新 文件 这 样 的 事情 。 如何 才 能 实现 这 个 功能 呢 ? 我 们 想当然 地 会 从 
资源 中 获得 chi1dren 属 性 ， 然 后 在 其 中 添加 一 个 文件 : 


filesystem/first-persistent.py 





def NaiveAddChildToDirectory(self, name, resource): 
children = self.getAttribute("children") 
if children is not None: 
children.value.append(resource) # WRONG! 


问题 是 这 并 不 能 正常 工作 。 如 前 所 述 ， 有 些 值 需 要 特定 的 类 型 。 属 性 的 值 的 类 型 是 文本 ， 
而 不 能 仅 把 资源 对 象 放 在 那儿 。 那 么 ， 我 们 如 何 表示 子 列表 呢 ?” 如 果 chi1ldren 真 的 只 是 男 一 个 
属性 ， 那 么 它 不 应 被 视 为 与 其 他 属性 有 任何 区 别 。 但 是 ,这 确实 会 很 束 手 。 那 么 ,我 们 能 做 些 什 
么 呢 ? 
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这 个 问题 并 不 容易 解决 , 因为 这 涉及 到 设计 一 个 良好 的 数据 仓库 模型 的 一 个 关键 因素 : 开发 
者 把 不 同 对 象 之 间 的 分 界线 划 在 哪里 ?以 及 ， 开 发 者 如 何 描述 对 象 之 间 的 关系 ?在 数据 仓库 中 ， 
开发 者 通过 引用 实现 此 功能 。 


13.2.1 数据 仓库 关键 字 和 引用 


当 涉 及 在 数据 仓库 中 处 理 chi1dren 属 性 的 值 时 ， 有 两 个 切实 的 选择 : 可 以 将 目录 结构 编码 
为 字符 串 ， 然 后 再 将 该 字符 串 放 到 属性 中 ， 或 者 可 以 将 chi1dren 属 性 看 作 一 个 特例 。 稍 后 再 来 
对 比 这 两 种 方法 具体 的 优 劣 之 处 ， 现 在 将 只 选择 简单 的 方法 ， 将 chi1dren 作 为 一 个 特例 。 目 录 
结构 是 文件 系统 中 的 关键 细节 ， 因 此 ， 虽 然 它 似乎 有 点 麻烦 ， 但 其 重要 性 足以 值得 去 特殊 对 待 。 

但 无 论 采 用 哪 种 方式 ， 都 会 违背 另 一 个 重要 因素 。 目 录 中 的 文件 是 一 个 独立 的 对 象 。 如 果 按 
照 传统 的 对 象 模 型 进行 思考 , 文件 并 不 是 包含 它 的 目录 的 一 部 分 。 它 是 一 个 独立 的 对 象 , 被 它 的 
父 目 录 所 引用 。 在 类 似 数据 仓库 的 系统 中 ， 这 种 区 分 尤为 重要 。 

假设 认为 文件 是 包括 它们 的 目录 的 一 部 分 ， 那么 ， 在 从 数据 仓库 取 回 文件 系统 的 根 目录 时 ， 
就 需要 从 数据 仓库 载 人 整个 文件 系统 。 根 目录 最 终 包 含 系统 的 每 个 文件 和 目录 , 如 果 根 目录 只 包 
含 其 中 一 部 分 ,这 部 分 也 将 使 用 根 目录 来 进行 存储 和 取 回 。 另 外 , 我 们 甚至 不 能 取 回 一 个 单独 的 
文件 ， 因 为 它 只 作为 根 目 录 里 的 一 个 属性 存在 。 

这 绝对 不 是 我 们 想 要 的 。 

文件 系统 应 该 是 一 个 由 各 独立 对 象 组 成 的 集合 。 按照 经 典 的 内 存 中 的 对 象 模 型 , 我 们 要 的 是 
一 个 指针 。 我 们 不 希望 目录 包含 其 子 节 点 ， 而 希望 它 指 向 它 的 子 闻 点 。 

数据 仓库 中 也 有 类 似 于 C++ 中 指针 的 东西 ， 它 被 称 为 引用 (reference )。 引 用 不 同 于 C++ 的 引 
用 ，C++ 的 引用 其 实 只 是 指针 的 另 一 个 名 称 。 对 象 存 储 ( object-store ) 的 引用 是 一 个 标识 符 ， 该 
标识 符 唯一 标识 了 数据 仓库 中 的 某 个 对 象 。 引用 就 像 是 数据 仓库 中 指向 目标 对 象 的 指针 , 它 不 是 
指向 它 的 位 置 ， 而 是 提供 了 一 个 标识 符 ， 通 过 该 标识 符 数 据 仓库 能 够 取 回 这 一 特定 的 对 象 。 

正如 之 前 提 到 的 ， 数 据 仓 库 中 存储 的 每 一 个 对 象 都 包含 一 个 唯一 的 标识 符 ， 称 为 关键 字 
( key )。 对 另 一 个 对 象 的 引用 是 一 个 特性 ， 该 特性 的 值 是 另 一 个 对 象 的 关键 字 。 到 目前 为 止 ， 我 
们 在 以 一 种 非常 原始 的 方式 使 用 关键 字 。 然 而 ，App Engine 为 我 们 提供 了 另 一 种 便捷 的 使 用 关键 
字 的 机 制 。 数 据 仓 库 中 的 引用 对 象 是 对 关键 字 的 封装 , 使 得 该 对 象 好 像 是 被 关键 字 本 身 所 标识 一 
样 。 当 开发 者 尝试 访问 一 个 引用 对 象 的 字段 或 方法 时 , 它 自己 会 自动 进行 取 回 ,然后 将 调用 转发 
给 取 回 的 对 象 。 就 我 们 的 文件 系统 而 言 , 这 意味 着 可 以 返回 一 个 特定 的 目录 中 的 所 有 子 对 象 的 列 
表 ， 而 不 用 真正 取 回 所 有 子 对 象 。 

来 看 一 下 如 何 实现 上 述 功能 。 创 建 一 个 新 版 本 的 资源 模型 类 型 ， 它 有 一 个 子 节点 专 有 的 特 
性 。 就 像 为 属性 模型 所 做 的 一 样 , 子 节点 的 特性 是 对 象 列表 ,其 中 每 个 元 素 都 是 一 个 “名 称 / 值 ” 
的 二 元 组 : 












































































































































































































































filesystem/persistent fllesystem.py 


@ class DirectoryEntry(db.Mode1) : 
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name = db.StringProperty() 
resource = db.ReferenceProperty(PersistentResourceMode1) 
@ 需要 定义 一 个 目录 项 的 模型 类 ， 也 就 是 一 个 典型 的 db.Mode1 的 子 类 
@ 该 句 声明 了 一 个 特性 ， 即 对 另 一 个 资源 的 引用 。 为 了 生成 引用 特性 , 用 db.Reference 值 
创建 一 个 字段 ， 并 为 构造 函数 提供 一 个 db.Mode1 子 类 的 参数 。 当 把 该 类 的 value 字 有 段 设 
定 为 特定 的 资源 时 ,会 保存 该 资源 的 关键 字 。 
现在 ， 可 以 编写 资源 定义 了 。 我 们 要 做 的 是 使 chi1dren 成 为 一 个 特例 一 一 我 们 固定 将 
chi1dren 属 性 连接 在 该 资源 上 ， 这 是 一 个 Di rectoryEntry 关 键 字 的 列表 。 


© 
































filesystem/persistent_filesystem.py 





class PersistentResource(db.Model): 
content = db.BlobProperty(default = "") 
attributes = db.ListProperty(db.Key) 
children = db.ListProperty(db.Key) 
@ 在 新 的 资源 模型 中 ， 子 节点 包含 了 一 个 特性 ， 是 DirectoryEntry 对 象 的 关键 字 的 列表 。 
我 们 不 使 用 对 该 条 目的 引用 ， 不 能 在 列表 特性 中 这 样 做 。 此 外 ， 从 概念 上 讲 ， 我 们 希望 
在 资源 对 象 中 包含 这 些 条 目 ， 这 就 意味 着 ， 只 能 从 资源 类 的 方法 内 部 存储 或 取 回 这 些 条 
目 。 引 用 的 要 点 是 ， 当 真正 的 取 回 发 生 时 ， 引 用 使 取 回 过 程 透明 。 然 后 ， 开 发 者 可 以 传 
递 引 用 ， 好 像 它 是 真实 的 对 象 ， 而 无 需 担心 真正 需要 它 的 值 的 时 候 如 何 取 回 它 。 但 是 ， 
在 这 里 ， 只 有 一 个 地 方 会 取 回 这 些 引 用 值 ， 所 以 引用 的 开销 就 无 需 考 虑 了 。 
现在 我 们 已 经 有 了 一 个 有 趣 的 设置 。 资 源 类 型 中 包含 一 个 目录 项 的 列表 , 该 列表 按照 关键 字 
访问 ， 且 目录 项 是 引用 。 我 们 如 何 将 此 设置 应 用 于 实现 目录 呢 ? 首先 ， 来 看 看 需要 如 何 修改 


getAttribute 和 setAttribute 方 法 ,以 便 使 用 目录 项 。 然 后 再 来 看 看 使 用 这 些 文件 系统 对 象 的 
代码 ， 了 解 我 们 实际 上 是 如 何 使 用 引用 的 。 
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filesystem/persistent_filesystem.py 


def GetAttribute(self, name): 
0 if name == "children": 


return [ DirectoryEntry.get(key) for key in self.children ] 
else: 


for attr_key in self.attributes: 


attr = ResourceAttribute.get(attr_key) 
if attr.name == name: 


return attr.value 
return None 


def SetAttribute(self, name, value): 
if name == "children": 


self.children = [ de.key() for de in value ] 
self.putO) 
else: 


for attr_key in self.attributes: 
attr = ResourceAttributeModel.get(attr_key) 
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if attr.name == name: 
attr.value = value 
attr.put() 
return 


newAttr = ResourceAttribute(name=name, value=value) 
newAttr .put() 
self.attributes.append(newAttr .keyO)) 
self.put() 
def IsDir(self): 
return (self.children is not []) 


@ 在 GetAttribute 方 法 中 ， 我 们 先 检查 一 下 属性 名 称 是 否 为 chi1dren。 虽 然 这 种 检查 令 
人 生 厌 , 但 由 于 处 理 的 内 容 的 局 限 性 ， 所 以 它 也 是 不 可 避免 的 。children 属 性 是 一 种 特 
例 ， 因 此 需要 显 式 地 检查 。 如 果 它 就 是 要 取 回 的 内 容 ， 那 么 我 们 使 用 特定 代码 取 回 资源 
的 子 节 点 , 和 否则, 就 直接 跳 到 与 之 前 使 用 的 相同 的 代码 处 。 如 果 正 在 取 回 chi1dren 属 性 ， 
那么 就 使 用 列表 遍历 : 遍历 DirectoryEntry 关 键 字 列 表 ， 取 回 实际 的 Di rectoryEntry 
对 象 ， 然 后 返回 该 列表 。 因 此 ， 对 于 我 们 的 文件 系统 的 客户 端 而 言 ， 当 它们 调用 
file.GetAttribute("children") 时 , 得 到 的 结果 就 是 一 个 目录 项 列表 。 但 是 这 里 隐藏 
了 一 点 小 技巧 : 正如 后 面 将 会 看 到 的 ， 对 于 这 段 代 码 的 客户 端 ， 目 录 项 的 行为 就 好 像 它 
们 确实 包含 子 节 点 资源 一 样 ， 但 实际 上 ， 它 们 只 包含 了 引用 。 
@ setAttribute 方 法 与 GetAttribute 方 法 大 体 相 反 。 我 们 以 完全 相同 的 方式 开始 ， 首 先 
仿 查 设置 了 什么 属性 。 如 果 是 chi1dren， 那 么 我 们 希望 其 值 是 一 个 DirectoryEntry 的 
列表 ,所 以 使 用 列表 遍历 ,实现 与 get 完 全 相反 的 工作 : 用 关键 字 替 换 目 录 项 ， 获 得 关键 
字 列 表 ， 然 后 将 其 存储 到 资源 特定 的 chi1dren 属 性 中 。 因 为 该 操作 修改 了 资源 ， 所 以 我 
们 需要 使 用 put 调 用 保存 。 
当 引 用 的 属性 设置 好 之 后 , 我 们 如 何 使 用 它 呢 ?数据 仓库 完成 了 所 有 的 工作 。 如 果 只 是 要 获 
取 数 据 仓 库 中 引用 实例 的 特性 值 ， 数据 仓库 会 自动 取 回 相应 内 容 ， 其 过 程 对 开发 者 完全 透明 。 因 
此 ， 举 例 来 讲 ， 我 们 可 以 使 用 下 面 的 函数 遍历 目录 中 的 子 节点 ， 打 印 出 每 个 子 节点 是 否 是 目录 : 









































































































































filesystem/persistent filesystem.py 


def RenderChildren(dir): 

children = dir.GetAttribute(children) 

for c in children: 
# Cc 是 DirectoryEntry 

0 if c.resource.IsDir(): 
print("Child %s is a directory" % c.name) 

else: 

print("Child %s is not a directory”% c.name) 


在 该 函数 中 ,遍历 目录 的 children 特 性 中 的 DirectoryEntry 值 。 一 个 值 ， 通 过 对 
DirectoryEntry 的 resource 字 段 调 用 IsDir 方 法 , 访问 其 引用 的 资源 。 这 个 字段 不 是 一 种 资源 ， 
它 是 一 个 引用 。 但 每 当 试 图 访问 引用 的 任何 字段 或 方法 时 一 一 正如 这 里 ， os r 方 法 
时 一 一 数据 仓库 会 自动 取 回 被 引用 的 对 象 。 
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到 目前 为 止 , 实现 似乎 非常 简单 一 一 几乎 很 简单 的 持久 性 也 会 变 得 极其 复杂 , 难以 获得 正确 
结果 ,但 是 到 目前 为 止 ,我 们 所 看 到 的 内 容 完 成 了 这 个 令 人 钦佩 的 工作 ， 隐 藏 了 其 中 的 复杂 性 。 
然而 ， 潜 在 的 复杂 性 依然 存在 。 

这 种 潜在 的 复杂 性 会 从 几 个 方面 影响 开发 者 。 最 明显 的 一 点 就 是 , 数据 仓库 在 我 们 使 用 引用 
时 ,自动 取 回 了 引用 , 这 虽然 不 错 , 但 实际 上 它 仍 然 是 一 个 对 数据 仓库 的 往返 调用 。 从 持久 性 存 
储 系统 中 取 回 内 容 并 不 是 免费 的 。 虽 然 这 个 过 程 并 不 是 非常 昂贵 , 远 不 如 做 一 个 查询 昂贵 , 但 它 
不 是 免费 的 ,而 且 这 样 做 的 成 本 会 逐渐 积累 ,最 后 变 得 相当 显著 。 把 取 回 操作 对 我 们 隐藏 ， 这 样 
做 固然 方便 ， 但 也 很 容易 让 代码 突然 变 得 很 慢 。 

例如 , 在 上 边 打印 目录 的 程序 里 , 按照 代码 中 的 方法 进行 目录 迭代 时 会 发 生 什 么 事情 呢 ? 该 
程序 取 回 了 目录 中 的 每 个 子 节点 的 资源 对 象 。 这 样 做 , 意味 着 取 回 了 目录 中 的 每 一 个 成 员 的 每 一 
个 子 节点 的 每 一 个 DirectoryEntry 的 关键 字 。 如 果 使 用 这 些 代码 ， 最 终 会 取 回 其 他 资源 对 象 的 
引用 。 编写 一 个 遍历 程序 遍历 目录 层次 结构 确实 很 容易 , 但 是 会 做 大 量 的 取 回 操作 ,每 个 取 回 操 
作 都 独立 作为 引用 访问 的 一 部 分 。 在 这 样 的 情况 下 , 我 们 用 一 个 单一 的 查询 语句 一 次 取 回 所 有 对 
象 会 更 好 。 如 果 开 发 者 不 习惯 云 风 格 的 分 布 式 编程 , 那么 ,这 种 对 引用 的 随意 使 用 ， 最 终 会 导致 
潜在 效率 非常 低 的 代码 ， 只 是 效果 不 很 明显 而 已 。 

通过 下 面 这 个 例子 ,开发 者 就 能 理解 其 潜在 影响 。 在 早期 的 职业 生涯 中 ， 我 曾 做 过 一 些 C++ 
持久 化 系统 的 相关 工作 ， 跟 自动 引用 取 回 操作 很 像 。 有 一 次 , 我 为 客户 做 一 些 示 例 代码 ,发 现 它 
的 性 能 完全 不 合理 。 一 个 循环 迭代 的 时 间 花 费 非常 巨大 。 它 并 不 与 列表 的 大 小 大 致 成 正比 ,而 是 
与 列表 大 小 的 平方 成 正比 。 这 个 问题 恰好 证 明了 我 在 上 文中 所 描述 的 问题 : 每 次 有 人 访问 列表 的 
成 员 ， 它 会 自动 取 回 其 子 节点 列表 ， 并 为 子 节点 建立 代理 (引用 的 形式 )。 因 此 ， 访 问 列 表 元 素 
实际 上 最 终 创建 了 一 个 代理 列表 。 看 起 来 没有 影响 的 一 行 代码 ， 由 于 系统 自作 聪明 的 幕后 操作 ， 
实际 上 代价 非常 昂贵 。 

在 数据 仓库 中 , 开发 者 需要 知道 到 底 发 生 了 什么 ,以 理解 其 各 项 花费 。 当 开发 者 访问 一 个 引 
用 参数 时 , 真正 做 的 是 对 数据 仓库 进行 一 个 调用 : db.get(key)。 这 会 引发 一 个 非常 昂贵 的 取 回 
操作 。 

有 时 候 这 是 一 个 很 现实 的 问题 ,但 是 ,开发 者 可 以 通过 显 式 地 使 用 关键 字 来 避免 此 问题 。 使 
用 关键 字 时 , 正如 我 们 使 用 Di rectoryEntry 对 象 的 实现 一 样 , 可 以 显 式 地 进行 取 回 操作 。 这 样 ， 
因为 取 回 操作 不 再 对 开发 者 隐藏 ， 在 代码 中 , 进行 了 多 少 取 回 操作 变 得 很 清晰 。 在 这 种 编程 中 有 
一 个 微妙 的 平衡 ， 即 在 使 用 简单 的 内 容 ( 如 引用 ) 和 显 式 的 内 容 〈 如 关键 字 ) 中 进行 选择 。 在 一 
般 情况 下， 如果 开 发 者 有 很 多 对 象 ， 我 建议 使 用 显 式 的 关键 字 。 虽 然 这 样 要 付出 更 多 努力 , 但 是 
能 让 你 更 清楚 地 知道 程序 的 行为 。 

构建 文件 系统 的 下 一 个 主要 问题 是 : 应 该 如 何 处 理 内 容 ? 在 初始 模型 中 , 我 们 在 一 个 文本 特 
性 中 存储 内 容 。 这 很 好 ， 但 不 是 非常 好 。 文 本 对 象 可 以 相当 大 ， 但 它们 仍然 基本 上 只 是 字符 串 。 
这 对 文件 系统 来 说 并 不 完全 正确 : 一 个 文件 系统 中 的 文件 的 内 容 可 以 任意 大 , 而 且 其 内 容 可 以 是 
任何 字 节 序列 。 

但 还 有 另外 一 个 问题 。 每 次 取 回 文件 对 象 时 ， 取 回 的 是 整个 文件 对 象 。 如 果 其 内 容 是 20 兆 字 
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节 , 并 且 我 们 想 要 做 的 工作 仅 仪 是 检查 该 文件 是 否 是 一 个 目录 呢 ?” 就 如 同 之 前 写 的 显示 函数 里 所 
做 的 事情 一 样 ， 这 种 实现 的 效率 低 得 难以 想象 。 请 记 住 : 在 云 中 ， 开 发 者 要 为 使 用 的 东西 付费 。 
开发 者 加 载 其 不 使 用 的 文件 的 内 容 所 花费 的 时 间 并 不 是 免费 的 。 我 们 真正 要 做 的 是 为 内 容 创建 另 
一 个 对 象 类 型 ， 这 样 就 可 以 使 用 引用 了 。 

最 终 的 对 象 模 型 ( 对 本 厄 而 言 ) 如 下 : 























filesystem/filesystemblobmodel.py 
OQ class ContentModel(db.Model): 
data = db.BlobPropertyQO) 


class DirectoryEntry(db.Mode1) : 
name = db.StringProperty() 
resource = db.ReferenceProperty(PersistentResourceMode1) 


class Resource(db .Mode1) : 
content = db.Reference(ContentModel) 
attributes = db.ListProperty(db.Key) 
children = Db.ListProperty(DirectoryEntry) 


这 与 之 前 的 内 容 的 确 很 接近 。 主 要 的 区 别 如 下 所 述 。 
@ 为 文件 内 容 创 建 了 一 个 新 的 类 。 它 唯一 的 属性 是 Blob。 除 了 不 是 解析 为 字符 串 序列 的 一 
系列 字 广 ， 它 很 像 文 本 ， 它 只 是 一 个 完全 不 解析 的 字 市 序列 。 对 于 文件 ， 这 正 是 我 们 想 
要 的 : 读 取 文件 内 容 的 程序 可 以 决定 如 何 解 释 该 B1ob。 
@ 在 Resource 类 中 ， 我们 使 用 了 对 内 容 对 象 的 引用 。 有 了 它 ， 取 回 资源 对 象 时 ， 我 们 只 要 
得 到 其 内 容 的 引用 即 可 。 只 有 试图 访问 内 容 时 ， 内 容 才 会 被 取 回 。 


13.2.2 ”实现 文件 系统 的 其 余部 分 


我 们 已 经 处 理 了 文件 系统 中 大 部 分 数据 仓库 ， 但 仍然 需要 用 一 些 粘 合 代 码 把 各 部 分 组 装 起 
来 。 到 目前 为 止 ， 我 们 所 做 的 是 实现 文件 和 目录 ， 因 此 需要 将 它们 组 合成 一 个 完整 的 文件 系统 。 

最 终 , 文件 系统 是 文件 和 目录 的 集合 ， 其 中 有 一 个 特殊 的 目录 ， 称 为 根 目 录 (root )。 所 有 对 
文件 系统 内 文件 的 引用 都 会 按照 相对 于 根 目录 的 方式 来 计算 , 因此 文件 系统 需要 做 的 另 一 件 工作 
已 经 隐 含 在 上 句 话 中 ， 即 文件 系统 需要 能 解析 它 所 引用 的 特定 文件 的 全 路 径 ， 如 果 它 不 能 解析 ， 
就 会 产生 错误 。 

那么 ， 怎 样 实现 一 个 最 低 限 度 的 文件 系统 呢 ? 参看 如 下 人 代码。 其中， 唯一 复杂 的 部 分 是 
GetResourceFromChi1dByList 的 实现 , 该 孔 数 递归 遍历 目录 层次 结构 ， 取 回 一 个 特定 文件 。 如 
果 对 下 面 的 代码 有 疑问 ,请 暂时 不 用 担心 ， 这 段 代码 对 理解 接 下 来 的 内 容 并 不 是 很 重要 。 它 所 做 
的 全 部 工作 就 是 从 像 /a/b/c.txt 这 样 的 路 径 开 始 , 首先 在 根 目录 查找 名 为 a 的 资源 , 然后 在 资源 
a 中 查找 名 为 b 的 子 节点 资源 ， 然 后 再 在 b 资 源 中 查找 名 为 c. txt 的 子 节 点 资源 ， 最 后 返回 c .txt， 
即 找到 正确 的 资源 。 
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filesystem/filesystem_servlet.py 


class Filesystem(db.Mode1) : 
root = db.Reference(Resource) 


def GetRoot(self): 
return self.root 


def GetResource(self, path): 
path_elements = path.split("/") 
return self.getResourceFromChildByList(self.root, path_elements) 


def GetResourceFromChildByList(self, resource, path_elements): 
if path_elements is []: 
return resource 
else: 
for direntry in resource.children: 
if direntry.name == path_elements[0]: 
return getResourceFromChildByList(direntry.resource, 
path_elements[1:]) 





return None 


13.2.3 ”用 GET 实 现 文件 获取 


解决 了 基本 的 文件 系统 模型 之 后 , 接 下 来 要 做 的 就 是 实现 该 文件 系统 。 文件 系统 的 数据 仓库 
的 各 部 分 都 很 容易 ， 至少 一 开始 是 这 样 。 要 实现 一 个 基本 的 的 文件 系统 ， 几 乎 就 是 一 系列 的 有 着 
完整 对 象 的 GET 和 PUT。 实 现 URL 上 映射 有 一 些 工 作 量 ， 但 这 与 我 们 之 前 看 到 的 并 没有 什么 差别 。 
不 过 , 我 们 将 会 看 到 ， 基 于 现 有 的 这 些 东西 就 可 以 做 一 些 更 好 玩 的 事情 ， 如 基于 属性 值 在 文件 系 
统 中 进行 查找 操作 。 

先 从 基础 开始 。 用 户 能 用 文件 系统 做 些 什么 呢 ? 

(1) 创建 资源 。 这 涉及 到 创建 资源 对 象 ， 设 置 其 属性 ， 存 储 其 内 容 ， 并 修改 其 父 节 点 资源 ， 
即 把 这 个 新 的 资源 提供 给 一 个 目录 项 。 

(2) 获取 资源 的 内 容 。 

(3) 设置 和 获取 资源 的 属性 。 

(4) 更 新 资源 的 内 容 。 

我 们 必须 将 这 些 动作 映射 到 基本 的 HTTP 操 作 上 : GET、PUT 和 POST。 获 取 资 源 的 内 容 或 者 它 
的 属性 显然 是 一 个 GET 操 作 ， 创 建 一 个 新 的 资源 或 者 更 新 其 内 容 为 PUT 操作 。 

事实 上 ， 现 在 我 们 不 需要 POST， 我 们 将 使 用 GET 来 实现 所 有 的 获取 ， 使 用 PUT 实现 所 有 的 












































存储 。 
现在 ,需要 思考 的 是 如 何 组 织 URL。 如 果 忽 上 略 属性 ， 那 么 这 很 容易 。URL 中 有 简单 的 路 径 ， 
而 且 标准 的 URL 语 法 也 正 是 为 此 设计 的 。 但 对 于 属性 则 有 点 环 手 。 可 以 使 用 CGI 参数 来 修改 HTTP 
调用 ， 或 者 可 以 创建 一 种 将 属性 编码 到 URL 的 方式 。 经 典 的 REST 风 格 提倡 后 者 的 做 法 。 属 性 是 
一 种 可 以 被 服务 访问 的 数据 ， 每 一 块 可 被 唯一 识别 的 数据 都 应 该 有 它 自 己 的 URL。 





























156 第 13 章 高 级 数据 仓库 : 特性 类 型 








属性 是 资源 的 元 数据 位 , 所 以 它们 的 URL 应 该 基于 其 相关 文件 的 URL。 为 了 防止 混 清文 件 的 
属性 和 目录 的 成 员 , 我 们 将 在 属性 前 加 前 级 “~”, 这 样 我 们 就 不 会 认为 是 资源 名 称 的 路 径 字 符 了 。 
即 ， 给 定 一 个 URIL 为 R 的 资源 ， 它 的 属性 a1 将 通过 R/~al1 的 URL 进 行 访问 。 

可 以 用 GET 处 理 程序 来 生成 文件 系统 服务 的 第 一 个 版 本 : 

















filesystem/filesystem_servlet.py 


class FilesystemResourceHandler (webapp.RequestHandler): 
def GetFilesystem(self): 
query = Filesystem.gql("") 
return query.get(); 


de 


下 


get(self): 
filesystem = self.GetFilesystem() 
root = filesystem.root 
url = self.request.path 
urlElements = url.split("/") 
# 然后 检查 它 完 竞 是 请 求 资源 内 容 ， 还 是 请 求 属性 。 
# 如 果 最 后 一 个 名 称 元 素 的 首 字符 是 "~"， 那 它 就 是 一 个 属性 
resourcePath = None 
attr = None 
@ if ur1E1ements[-1].startswith("~”) : 
attr = urlElements[-1] 
resourcePath = urlElements[:-1] 
else: 
resourcePath = urlElements 
resource = filesystem.getResourceFromChildByList(root, resourcePath) 
if resource is None: 
self.response.error(404) 
return 
@ if attr is not None: 
result = resource.getAttributeCname) 
if result is None: 
self.response.error(404) 
self.response.out.write(str(result)) 
return 
else: 
© self.response.out.write(resource.content.data) 


@ 首先 ， 对 于 云 应 用 程序 而 言 ， 通 常 需要 调用 取 回 功能 ， 获 取 文 件 系统 的 根 对 象 。 我 们 知 
道 该 如 何 编写 该 功能 ， 这 只 是 一 个 简单 的 数据 仓库 取 回 。 

@ 通过 文件 系统 ， 可 以 得 到 根 资源 ， 也 就 是 文件 系统 的 根 目录 。 

@ 然后 来 看 请 求 ， 从 其 中 获取 想 要 取 回 的 资源 的 路 径 。 

@ 解析 该 路 径 ， 看 看 它 是 否 是 对 一 个 属性 或 者 资源 内 容 的 请 求 。 

@ 使 用 之 前 在 上 一 章 中 写 的 方法 ， 取 回 资源 对 象 。 

@ 如 果 获 取 资 源 的 尝试 失败 ， 则 返回 空 值 。 因 此 产生 一 个 404 响 应 ( 即 ，HTTP 对 “未 找到 
资源 ”的 响应 )。 

@ 如 果 URL 中 包含 


@Q@ 


9O 



































性 名 称 ， 取 回 该 属性 ， 并 在 结果 消息 的 内 容 中 返回 属性 。 如 果 不 指定 
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结果 代码 ， 它 会 默认 为 成 功 的 代码 ， 而 且 content-type 会 默认 为 UTF-8 文 本 。 由 于 这 些 
都 是 我 们 所 希望 的 ， 所 以 ， 只 需 将 属性 值 写 入 响应 数据 流 即 可 。 

@ 否则 ， 我 们 使 用 数据 仓库 的 引用 自动 取 回 功能 ， 获 得 资源 的 内 容 ， 并 将 其 写 人 数据 流 。 
同样 ， 默 认 值 能 很 好 地 工作 : 当 我 们 向 响应 输出 流 写 一 个 blob 时 ， 如 果 该 blob 只 是 文本 
字符 ， 它 会 默认 为 UTF-8; 如 果 它 有 任何 非 文本 字 节 ， 它 会 默认 为 字 节 流 。 


13.2.4 用 PUT 实现 文件 存储 


在 实现 文件 存储 中 ， 值 得 关注 的 事情 是 ， 当 开发 者 PUT 文件 时 ， 可 能 还 需要 更 新 其 父 文件 ， 
从 而 为 新 资源 创建 一 个 新 的 目录 项 。 

PUT 的 代码 与 GET 非 常 相似 。 我 们 从 解析 路 径 开 始 。 如 果 PUT 是 内 容 更 新 ， 则 需要 获取 资源 ， 
如 果 资 源 尚 不 存在 ， 就 获取 其 父 资源 。 如 果 是 一 个 属性 更 新 ,资源 必须 存在 ， 所 以 我 们 需要 先 获 
取 资 源 本 身 ， 然 后 ， 做 相应 的 更 新 。 






































filesystem/filesystem_servlet.py 


def put(self): 
filesystem = GetFilesystem() 
root = filesystem.root 
url = self.request.path 
urlElements = url.split("/") 
resourcePath = None 
attr = None 
if urlElements[-1].startswith("~"): 
attr = urlElements[-1] 
resourcePath = urlElements[:-1] 
else: 
resourcePath = urlElements 
resource = filesystem.getResourceFromChildByList(root, resourcePath) 
0 if resource is None: 
parent = filesystem.getResourceFromChildBylist(root,resourcePath[0:-1]) 
name = resourcePath[-1] 
if parent is None: 
self.response.set_status(404, "Parent dir of new resource not found") 
else: 
resource = Resource(content = self.request.body, attributes=[],， 
children=[]) 
resource.put() 
© dirEntry = DirectoryEntry(name=name,resource=resource) 
parent.children.append(dirEntry) 
parent.put() 
self.response.set_status(100, "Resource created") 
return 
else: 
@ resource.content=self.request.body 
resource.putO) 
self.response.set_status(100, "Resource updated") 
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@ 在 尝试 取 回 资源 的 地 方 之 前 ， 一 切 都 和 GET 的 过 程 很 像 。 在 GET 中 ， 如 果 不 能 找到 所 请 求 
的 资源 ， 就 会 返回 一 个 错误 ， 而 在 PUT 中 ， 则 尝试 创建 该 资源 。 为 了 创建 它 , 需要 获取 父 


资源 。 如 果 找 不 到 父 资 源 ， 就 返回 一 个 错误 。 但 
源 作为 它 的 子 资源 。 
@ 通过 实例 化 模型 类 ， 可 以 创建 一 个 新 的 资源 。 该 








参数 。 资 源 被 创建 后 ， 我 们 使 用 put 〇 将 它 保 存 到 数据 仓库 。 














目 新 的 资源 创建 并 存储 后 ， 我 们 需要 在 它 的 父 对 象 





如 果 能 找到 父 资源 ， 就 继续 创建 新 的 资 





模型 的 每 个 特性 是 构造 函数 的 一 个 命名 








中 为 其 创建 一 个 目录 项 ， 把 新 资源 加 到 


它 的 父 对 象 资源 中 ， 并 使 用 put 保 存 更 新 后 的 父 资源 。 
@ 如 果 资 源 已 经 存在 ， 则 只 需 更 新 其 内 容 ， 然 后 对 该 资源 利用 put 方 法 。 











13.3 ”特性 类 型 引用 
Google App Engine 提 供 了 相当 多 数据 仓库 模型 的 特 牧 











E 的 支持 。 在 本 方 中 ,， 我 们 将 浏览 一 系列 





特性 。 这 有 点 杜 燥 , 但 是 ， 有 这 人 么 一 个 完整 的 列表 方便 今后 查询 ， 是 很 方便 的 。 数 据 仓库 支持 的 
特性 ， 大 致 分 为 两 种 类 别 。 一 种 是 原始 类 型 ， 对 于 在 数据 仓库 中 存储 东西 非常 重要 的 基本 类 型 ; 
男 一 种 是 效用 类 型 ， 这 是 更 加 专用 的 东西 (例如 邮箱 地 址 )， 由 于 这 些 类 型 经 常 出 现 ， 所 以 提供 
























































了 标准 化 的 格式 和 验证 方法 。 
13.3.1 原始 特性 类 型 


口 BlobProperty 
blob 是 一 个 “二 进 制 的 大 型 对 象 "”， 换 名 话说 ， 





个 任意 大 小 的 字 方 块 。 开 发 者 不 能 在 查 





询 语句 中 使 用 任何 有 关 blob 的 东西 ， 它 们 没有 可 比 性 ， 也 无 法 排序 。blob 特 性 的 值 是 
db.B1ob 的 实例 ， 这 是 一 个 str 的 子 类 。 因 此 ， 开 发 者 可 以 在 其 代码 中 使 用 plob ， 就 好 像 


它们 是 字 节 串 ， 因 为 它们 确实 就 是 字 节 串 ! 
口 BooleanProperty 




















口 ByteStringProperty 











BooleanProperty 是 一 个 单一 的 布尔 值 ，True 或 者 False。 


基本 上 是 与 blob 同 样 的 东西 ， 但 有 索引 ， 并 像 字 符 串 一 样 长 度 有 限 。 
口 DateProperty /DateTimeProperty /TimeProperty 





时 间 惟 对象。 在 Python 中 ， 作 为 datetime.datetime 的 一 个 实例 实现 。 它 实际 上 有 三 个 
版 本 , 大 致 是 相同 的 , 因为 都 是 DateTime 对 象 。 使 用 DateProperty, 时 间 字 段 保 留 为 空 ; 
使 用 TimeProperty， 日 期 字段 为 空 。 它 们 在 查询 结果 中 按时 间 顺 序 排序 。 























口 FloatProperty 
一 个 浮 点 数 。 

口 IntegerProperty 
一 个 64 位 整 型 值 。 
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口 Key 
该 特性 用 来 存储 唯一 区 别 于 其 他 数据 仓库 对 象 的 关键 字 。 关 键 字 应 该 是 完全 不 透明 的 ， 
它们 不 可 排序 ， 除 了 相等 之 外 无 法 进行 其 他 任何 比较 。 如 果 开 发 者 确实 需要 ， 那么 有 分 
解 关键 字 提 取信 息 的 方法 ,但 是 ， 大 多 数 时 候 ， 如 果 开 发 者 需要 进行 关键 字 信 息 提取 ， 
只 能 说 明 这 是 持久 化 设计 具有 严重 问题 的 征兆 。 

口 ListProperty 
数据 仓库 支持 的 一 系列 数据 类 型 。 它 将 列表 元 素 的 类 型 作为 参数 。 不 同 于 通常 的 Python 
代码 ， 开 发 者 不 能 有 混合 类 型 的 列表 ， 数 据 仓库 列表 特性 只 能 存储 个 单一 类 型 的 值 。 此 
外 ， 还 有 StringListProperty， 这 只 是 ListProperty(item_type = basestring) 的 
缩写 。 

口 ReferenceProperty 
对 于 某 特定 类 型 对 象 的 引用 。 被 引用 对 象 的 类 型 是 构造 函数 的 一 个 参数 。 当 开发 者 取消 
一 个 ReferenceProperty 时 ， 数 据 仓库 会 自动 地 、 透 明 地 进行 get 操 作 以 取 回 对 象 。 

口 SelfReferenceProperty 
一 个 对 象 包含 了 对 同类 型 对 象 引 用 的 引用 特性 的 便捷 缩写 。 如 果 资 源 中 有 一 个 字段 是 其 
他 资源 ,我 们 可 以 使 用 Se1fReferenceProperty 来 定义 它 ， 而 不 是 ReferenceProperty 
(CResource)。 



















































































口 StringProperty 

一 个 字符 串 值 。 

口 TextProperty 

TextpProperty 是 字符 串 和 blob 之 间 的 交集 。 这 是 一 个 字符 串 类 型 ， 其 值 解析 为 Unicode 
字符 串 。 但 是 ， 像 blob 一 样 ， 它 可 以 是 任意 大 小 ,并且 它 的 值 不 能 在 查询 语句 中 使 用 。 


13.3.2 ”复杂 特性 类 型 


口 CategoryProperty 

一 个 字符 串 特 性 。 该 特性 在 构建 像 Atom 订 阅 这 样 的 内 容 中 使 用 ， 它 代表 一 个 atom 目 录 。 

口 Email1Property 
字符 串 的 一 个 子 类 ， 它 代表 电子 邮件 地 址 。 与 大 多 数 专用 类 型 不 同 ， 该 类 型 没有 提供 邮 
件 地 址 的 语法 验证 。 它 唯一 有 用 的 是 作为 给 阅读 开发 者 代码 的 人 们 的 一 个 提示 ， 其 特性 
值 会 被 解析 为 电子 邮件 地 址 。 

DQ GeoPtProperty 
一 个 地 理 位 置 。 该 值 是 一 个 XML 元 素 ， 包 含 标准 的 GEORSS 表 示 形 式 的 地 址 ， 其 定义 参 
见 http://georss.org。 

DQ IMProperty 

即时 消息 句柄 的 表示 。 该 特性 可 以 被 Google App Engine 服 务 用 于 即时 消息 服务 的 通讯 。 

它 从 标识 即时 消息 协议 和 用 户 名 的 URL 构 造 而 来 。 例 如 ， 我 的 Google Takk 的 即时 消息 将 
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征 db.IM( "http:V//talk.google.com"， "markccQgmail.com")。 
口 LinkProperty 
LinkProperty 是 一 个 字符 串 , 其 中 包含 一 个 有 效 的 URL。 这 是 设计 用 于 Atom 订 阅 的 , 但 
是 ， 它 对 于 任何 需要 存储 链接 的 应 用 程序 普遍 有 用 。 它 提供 了 对 URL 的 充分 验证 。 
口 PhoneNumberProperty 
一 个 包含 电话 号 码 的 经 过 验证 的 字符 串 。 该 特性 针对 各 种 国际 标准 的 电话 号 码 格式 进行 
了 验证 。 
口 PostalAddressProperty 
一 个 字符 串 值 ， 其 中 包含 邮政 地 址 。 
口 RatingProperty 
一 个 标识 用 户 等 级 或 排名 的 值 。 它 是 从 0 到 100 的 一 个 整数 。 


13.4 ”特性 类 型 结束 语 


在 这 一 章 中 , 我 们 深入 了 解 了 数据 仓库 。 学 习 了 可 以 在 数据 仓库 中 使 用 的 特性 类 型 ,看 到 了 
在 存储 的 对 象 中 容器 和 引用 之 间 的 差异 , 学 习 了 关键 字 和 引用 , 这 是 在 数据 仓库 中 管理 存储 对 象 
之 间 的 关系 的 主要 机 制 。 利 用 这 些 内 容 实现 了 数据 仓库 中 的 文件 系统 服务 的 基本 结构 。 

关于 数据 仓库 , 还 有 很 多 要 学 习 的 内 容 。 为 了 生成 一 个 高 效 的 、 可 扩展 的 数据 仓库 模式 ， 我 
们 需要 知道 如 何 定义 索引 , 以 及 如 何 选 择 并 创建 合适 的 索引 , 以 支持 希望 执行 的 查询 语句 。 当然 ， 
还 有 很 多 可 以 使 用 模型 完成 的 工作 。 到 目前 为 止 , 已 经 看 到 的 模型 有 一 组 固定 的 特性 。 数 据 仓库 
确实 允许 我 们 定义 模型 ， 并 且 可 以 根据 需要 添加 新 的 特性 ， 但 是 这 样 做 有 其 自身 的 一 些 限制 。 

下 一 章 将 介绍 一 些 更 高 级 的 数据 仓库 功能 。 我 们 将 重点 关注 查询 问题 ， 如 索引 、 关 键 字 、 游 
标 和 策略 ， 以 及 查询 语句 的 工作 原理 。 另 外 ， 还 将 介绍 如 何 能 够 创建 更 加 灵活 、 可 扩展 的 模型 。 
同时 ， 我 们 会 通过 增加 查询 特定 特性 的 资源 的 方式 ， 在 文件 系统 实现 上 增加 更 多 功能 。 
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在 上 一 章 中 , 我 们 了 解 了 可 以 在 Google App Engine 数 据 仓库 中 用 作 特 性 的 值 的 类 型 。 虽然 主 
要 用 的 是 Python 来 处 理 , 但 该 特性 类 型 集 对 Java 和 Python 都 是 相同 的 一 一 也 就 是 说 在 Java 和 Python 
中 都 能 够 作为 可 存储 对 象 的 字段 的 值 的 类 型 。 

本 章 将 基于 此 来 介绍 数据 仓库 中 查询 实际 的 工作 原理 。 在 后 台 , 使 查询 工作 快速 、 可 扩展 的 
过 程 是 使 用 索引 完成 的 。App Engine 的 SDK 可 以 根据 用 户 的 代码 为 其 数据 自动 生成 索引 , 但 有 时 
用 户 自己 定义 索引 可 以 带 来 更 好 的 性 能 ， 并 使 用 更 少 的 索引 。 同样 , 像 上 一 章 一 样 ， 我们 大 部 分 
工作 用 Python 完 成 ， 但 是 在 Python 和 Java 中 ， 查 询 和 索引 工作 完全 相同 ， 也 就 是 说 ， 无 论 用 户 使 
用 哪 种 语言 ， 都 需要 为 同 种 类 型 的 查询 按照 完全 相同 的 方式 创建 自 定 义 索引 。 

在 这 一 章 中 ， 我 们 将 了 解数 据 仓库 如 何 生成 索引 ， 以 及 如 何 通 过 在 app.yam1 中 声明 索引 的 
方式 定义 自己 的 索引 。 我 们 将 用 该 方法 定义 文件 属性 的 索引 ， 从 而 能 够 搜索 文件 系统 ， 男 外 ， 将 
最 终 形 成 部 署 文件 系统 应 用 程序 所 需 的 完整 的 app.yam] 文 件 。 


14.1 数据 仓库 中 的 索引 和 查询 


在 深入 App Engine 的 索引 工作 原理 的 细节 之 前 ， 值 得 先 花 一 些 时 间 学 习 一 些 幕后 的 技术 。 基 
于 这 些 索引 技术 的 数据 仓库 索引 和 数据 仓库 查询 , 与 大 多 数 人 习惯 使 用 的 类 似 方法 完全 不 同 。 数 
据 仓库 的 索引 有 很 多 限制 , 除非 开发 者 知道 究竟 是 什么 原因 造成 的 ,否则 这 些 限 制 看 起 来 简直 很 


14.1.1 揭 开 数据 仓库 的 面纱 


最 终 , 我 们 存放 到 数据 仓库 的 所 有 数据 实际 上 是 使 用 称 为 Bigtable 的 Google 存 储 系统 存储 的 。 
虽然 开发 者 并 不 直接 对 Bigtable 编 程 来 使 用 数据 仓库 ,但 是 ，Bigtable 定 义 了 数据 仓库 的 存储 、 查 
询 ， 以 及 性 能 的 基本 特性 。 

如 果 不 深入 太 多 细节 的 话 , 那么 ，Bigtable 所 提供 的 用 于 存储 数据 的 结构 与 开发 者 听 到 “ 表 ” 
的 时 候 可 能 想到 的 内 容 并 不 完全 相同 。Bigtable 的 存储 模式 很 有 技巧 。 在 某 些 方面 ， 它 提供 了 表 ， 
但 是 ， 这 些 表 并 不 像 关 系数 据 库 的 表 。 人 们 使 用 Bigtable 和 数据 仓库 工作 时 最 常见 的 错误 就 是 像 
在 关系 数据 库 中 一 样 设置 数据 。 在 关系 数据 库 中 ， 开 发 者 做 很 多 的 工作 以 提高 性 能 和 可 查询 性 ， 
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例如 数据 标准 化 。 但 是 ,如 果 开 发 者 在 数据 仓库 中 进行 数据 标准 化 , 那么 ， 着实 会 影响 程序 的 性 
能 ， 并 且 查 询 语句 的 编写 会 变 得 更 加 困难 ! 

数据 标准 化 是 关系 数据 库 的 编程 人 员 喜 欢 使 用 的 一 种 技巧 , 因为 在 关系 系统 中 数据 标准 化 能 
够 带 来 绝对 巨大 的 益处 。 其 思想 是 ,开发 者 尝试 把 所 有 内 容 推 倒 , 使 每 个 单独 的 表 尽 可 能 是 扁平 
的 : 复杂 数据 结构 以 表 之 间 的 关系 形式 存储 。 例如， 如 果 开 发 者 有 一 个 对 象 ( 如 我 们 的 Resource 
资源 对 象 )， 该 对 象 包含 了 一 组 值 的 集合 ( 如 我 们 的 Attribute 属 性 值 )， 那么 ,开发 者 会 将 这 些 
值 通过 一 个 中 间 表 分 隔 。 也 就 是 说 ， 开 发 者 需要 从 资源 对 象 的 存储 模型 中 彻底 删除 属性 ， 并且 要 
为 每 个 属性 添加 一 个 唯一 的 标识 符 。 然 后 ， 开 发 者 会 在 单独 的 表 中 存储 Resource 和 Attribute 
值 , 并 添加 第 三 个 表 , 称 为 关系 表 , 关系 表 中 包含 了 资源 标识 符 和 属性 标识 符 的 组 合 列表 。 因 此 ， 
要 检索 资源 的 属性 ， 开 发 者 可 以 进行 查询 ， 类 似 于 select attr from attributes, rel where 
attr.id = rel.attr_id and rel.resid = ?。 

而 在 数据 仓库 中 ， 开 发 者 真 的 不 希望 这 样 做 。 

与 关系 数据 库 的 表 比 起 来 ，Bigtable 更 像 是 两 级 的 散 列表 或 者 查找 表 。 

大 多 数 人 认为 的 表 是 一 个 矩形 网 格 , 行 和 列 有 标签 。 每 行 具有 完全 相同 的 列 。 这 就 是 关系 数 
据 库 中 使 用 的 表 的 模型 。 

Bigtable 有 行 和 列 ， 但 它们 与 关系 数据 库 的 行 和 列 不 同 。 在 Bigtable 中 ， 所 有 数据 都 以 行 存 
储 。 每 行 只 有 一 个 关键 字 。 人 快速 访问 行 的 唯一 途径 是 知道 其 关键 字 。 反 过 来 ， 每 一 行 由 一 组 列 
组 成 ， 但 列 完全 是 任意 的 。 不 同 的 行 可 以 有 完全 不 同 的 列 。 而 且 ， 每 一 行 可 以 有 成 千 上 万 个 不 
同 的 列 ! 

这 就 回 到 了 前 边 我 所 指 的 Bigtable 是 两 级 散 列 表 的 意思 。 给 定 表 中 的 一 行 的 关键 字 ， 开 发 者 
可 以 非常 快 地 取 回 该 行 。 也 就 是 说 ， 在 顶层 ，Bigtable 的 功能 类 似 于 散 列 表 或 者 字典 ， 让 开发 者 
快速 查找 与 特定 的 关键 字 关 联 的 行 。 一 旦 开发 者 获得 该 行 ， 就 好 像 获得 了 一 个 列 的 散 列表 ， 即 只 
要 开发 者 具有 行 和 列 的 标识 符 ， 就 可 以 非常 迅速 地 从 散 列 表 中 取 回 某 个 特定 的 列 。 

除了 查找 工作 之 外 , 事务 都 是 以 行为 中 心 的 每 个 事务 都 是 保护 单一 行 上 的 操作 。 每 次 当 
开发 者 进行 涉及 多 个 Bigtable 行 的 数据 仓库 的 更 新 操作 时 ， 就 会 大 大 增加 事务 的 复杂 性 。 

当然 ， 开 发 者 并 不 确切 知道 其 模型 是 如 何 映射 到 一 个 Bigtable 上 的 。 事 实 上 ， 随 着 时 间 的 
推移 ， 开 发 者 的 数据 映射 到 Bigtable 的 方式 可 能 会 发 生 改变 。 但是， 映射 的 主体 架构 是 非常 直 
观 的 。 

在 数据 仓库 中 ， 每 一 个 模型 对 象 是 Bigtable 的 一 行 。 即 使 开发 者 采用 了 列表 字段 如 我 们 
的 资源 对 象 的 属性 字段 一 一 在 对 象 中 保留 该 字段 ， 意 味 着 将 在 相同 的 Bigtable 行 中 保留 这 些 值 ， 
这 会 有 显著 的 性 能 优势 。 因此 , 对 于 数据 仓库 中 的 性 能 , 开发 者 实际 上 要 做 的 工作 与 标准 化 相反 ， 
即 ， 并 不 是 尽 可 能 地 将 对 象 遍 平 化 ， 而 是 要 把 它们 捆绑 起 来 ! 

类 似 地 ， 查 询 的 工作 方式 也 与 Bigtable 相 关 。Bigtable 支 持 基于 比较 对 一 系列 值 进 行 搜索 的 方 
法 。 但 由 于 Bigtable 的 实现 方式 ， 这 种 方法 受到 了 限制 。 所 有 的 查询 限制 都 来 自 于 Bigtable 的 基本 
特性 。 因 此 ， 举 全 来 说 ,在 任何 查询 中 , 开发 者 只 能 在 一 个 字段 上 进行 关系 比较 。 这 是 因为 关系 
比较 只 有 通过 索引 才能 高 效 实现 ， 而 开发 者 在 Bigtable 的 查询 中 只 能 使 用 一 个 索引 。 
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14.1.2 ”自动 生成 的 索 3 


正如 我 前 面 所 说 的 ，App Engine 的 SDK 可 以 自动 生成 数据 仓库 的 索引 。 基 本 上 ， 当 开发 者 首 
次 执行 一 个 dev_appserver.py 提 供 的 使 用 本 地 App Engine 执 行 环 境 的 特定 查询 时 ，App Engine 
就 会 检查 开发 者 的 存储 模型 ， 看 看 是 否 有 适合 该 查询 的 索引 。 如 果 有 ,那么 它 就 使 用 该 索引 ; 如 
果 没 有 ， 它 会 创建 一 个 。 
对 于 大 多 数 应 用 程序 而 言 ， 这 种 处 理 方法 很 好 。 开 发 者 不 必 担 心 索引 ,数据 仓库 会 为 开发 者 
处 理 好 它 。 开 发 者 只 要 根据 其 应 用 程序 的 自然 特性 来 定义 模型 ( 切记， 当然 ， 开 发 者 是 为 数据 仓 
库 定义 模型 ， 而 不 是 为 关系 数据 库 ! )， 数 据 仓 库 的 基础 设施 会 尽力 使 开发 者 的 查询 快速 运行 。 
但 往往 自动 的 东西 并 不 完美 。App Engine 和 数据 仓库 只 是 尝试 着 为 某 些 它 明确 知道 可 以 正确 
索引 的 情况 自动 生成 索引 。 如 果 开 发 者 想 在 此 范围 外 工作 ， 就 需要 自 定义 索引 。 
那么 什么 情况 下 数据 仓库 知道 如 何 做 正确 呢 ? 有 以 下 4 种 常见 情况 。 
口 等 式 过 滤器 
数据 仓库 为 所 有 字段 内 置 了 等 式 索 引 。 如 果 开 发 者 需要 的 是 基于 等 式 比较 的 查询 一 一 也 
就 是 说 ， 任 何 整个 过 滤 语 句 为 WHERE x = y (或 由 AND 连 接 的 一 系列 等 式 比较 ) 的 查询 语 
句 ， 那么 ， 开 发 者 不 需要 担心 生成 索引 的 问题 ， 数 据 仓库 总 会 有 其 索引 。 
口 无 过 滤器 ， 有 序 的 
如 果 开 发 者 正在 做 一 个 查询 ， 其 中 没有 比较 ， 而 且 只 有 一 组 按照 单一 顺序 进行 排序 的 值 
(例如 , 一 个 返回 按 日 期 排序 的 所 有 聊天 消息 的 查询 语句 ), 那么 ,App Engine 可 以 自动 生 
成 索引 。 

口 对 象 等 式 ， 特 性 关系 式 
对 于 最 上 面 一 级 的 持久 性 对 象 之 间 的 所 有 比较 都 是 等 式 测试 ， 或 者 特性 之 间 的 所 有 比较 
都 是 相同 特性 的 关系 比较 的 查询 语句 ，App Engine 可 以 自动 生成 过 滤器 。 

口 关系 式 过 滤器 

如 果 开 发 者 的 查询 比较 中 唯一 的 过 滤器 是 关系 比较 ( 即 小 于 或 大 于 )， 并 且 所 有 的 比较 都 

是 同一 特性 的 ， 那么 ，App Engine 可 以 自动 生成 索引 。 
虽然 上 述 内 容 看 似 有 限 , 但 它们 确实 覆盖 了 开发 者 常会 遇 到 的 大 多 数 情 况 。 例 如 ,在 我 们 的 
聊天 应 用 程序 中 ， 曾 使 用 了 查询 语句 ， 比 较 了 一 个 消息 的 chat 特 性 与 一 个 特定 值 ， 以 便 在 聊天 
室 中 显示 该 消息 。 那 是 一 个 等 式 比较 一 一 因此 ， 根 据 上 述 第 一 种 情况 ，App Engine 会 自动 索引 。 

事实 上 , 到 目前 为 止 , 我 们 写 的 每 一 个 查询 语句 都 属于 缺 省 索引 。 缺 省 索引 已 经 足够 用 了 , 几 
乎 我 们 想 写 的 每 个 查询 都 可 用 缺 省 索引 表达 。 所 以 找 出 一 个 使 用 自 定 义 索引 的 例子 确实 也 比较 难 ! 
















































































14.1.3 ”创建 自 定义 索引 


正如 之 前 所 说 的 ,在 大 多 数 情况 下 , 开发 者 可 以 绕 开 自动 生成 索引 的 种 种 限制 。 此 时 ， 就 应 
该 使 用 自动 索引 。 这 些 限制 都 是 有 原因 的 。 当 扩展 到 大 量 数据 时 , 很 多 相关 因素 就 会 带 来 潜在 性 
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能 问题 。 例 如 ， 我 们 将 要 用 到 的 查询 要 求 App Engine 跟 踪 两 个 相同 模型 类 型 的 不 同 特性 的 排序 ， 
这 就 会 给 数据 仓库 中 的 模型 类 型 的 每 次 更 新 增加 成 本 .所 以 ,在 开发 者 开始 构建 自 定义 索引 之 前 ， 
应 仔细 想 想 是 否 真 的 需要 它们 。 在 许多 情况 下 , 更 好 的 方式 是 使 用 一 个 返回 很 多 数据 的 简单 的 查 
询 语句 ， 然 后 在 开发 者 的 servlet 代 码 中 过 滤 这 些 数 据 ， 而 不 是 使 用 一 个 复杂 的 查询 语句 ， 复 杂 查 
询 语句 的 索引 对 每 次 更 新 会 有 负面 的 影响 。 这 里 有 一 个 微妙 的 权衡 : 如 果 能 够 为 开发 者 节省 大 量 
的 通信 ， 自 定义 索引 就 是 有 意义 的 。 因 此 ， 如 果 开 发 者 经 常 使 用 一 个 特定 查询 ， 并 且 可 以 大 大 减 
少 由 查询 产生 的 数据 量 , 那么 ,就 可 能 值得 使 用 自 定 义 索 引 。 但 是 ， 如 果 自 定义 索引 并 不 经 常 被 
使 用 , 或 者 在 查询 结果 的 数量 上 没有 较 大 差异 ,那么 开发 者 可 能 最 好 应 简化 处 理 , 换 句 话 说 ， 坚 
持 用 标准 索引 。 

为 了 进一步 探讨 ， 让 我 们 来 考虑 一 个 真正 需要 自 定义 索引 的 例子 。 

我 们 需要 做 的 是 提出 一 个 合理 的 、 并 不 适合 任何 自动 索引 约束 的 查询 。 基 本 上 ,开发 者 需要 
自 定义 索 引 的 地 方 , 是 当 开 发 者 要 使 用 复合 查询 测试 多 个 字段 的 相等 性 和 单一 字段 的 多 种 关系 的 
时 候 。 在 我 们 的 文件 系统 中 , 没有 任何 对 象 可 以 写 出 一 个 这 样 的 查询 ! 事实 上 , 在 许多 App Engine 
程序 中 , 开发 者 的 数据 模型 最 终 都 是 类 似 于 这 样 ， 没 有 情形 需要 自 定 义 索引 。 但 是 ,假设 有 一 个 
稍微 不 同 的 模型 ， 像 这 样 : 

class ResourceAttribute(db .Mode1) : 

name = db.StringProperty(required=True) 


type = db.StringProperty(required=True) 
value = db.TextProperty(required=True) 


因此 ， 我 们 给 ResourceAttribute 模 型 增加 了 一 个 新 特性 ， 使 用 该 特性 可 以 给 一 个 给 定 资 源 分 
配 类 型 名 称 。 类 型 名 称 将 会 告诉 我 们 如 何 解析 其 值 的 特性 。 因 此 , 举例 来 说 , 可 以 假想 一 个 系统 ， 
其 中 的 一 些 特 性 是 一 个 安全 系统 的 一 部 分 。 这 些 特性 将 采用 security-1eve1 类 型 。 那 么 ,我们 
可 能 要 找到 所 有 名 为 protection， 声 明 的 安全 级 别 在 400 到 500 间 的 security-1eve1 属 性 。 

用 GQL， 会 得 到 如 下 查询 : 


select a from attributes 
where a.name = "protection" 
and a.type = "security-level" 
and a.value >= "400" and a.value < 500 
































































































































该 查询 不 会 有 自动 生成 的 索引 ,因为 它 有 两 种 不 同 特性 的 等 式 测试 , 并 且 有 对 第 三 个 特性 的 关系 
比较 。App Engine 的 SDK 不 会 自动 生成 索引 ， 这 是 因为 索引 创建 代价 太 大 ， 所 以 它 留 给 用 户 来 决 
定 是 否 真 的 需要 该 索引 。 

要 创建 自 定义 的 索引 ， 需 要 在 我 们 的 应 用 程序 的 app.yam] 文 件 中 声明 该 索引 。app.yam] 文 
件 是 Python 应 用 程序 的 主 配 置 文件 。 该 文件 用 一 种 ( 丑陋 的 ) 标记 语言 编写 ， 名 为 YAML。 索 引 
定义 在 该 文件 内 的 indexes 节 下 边 。 每 个 索引 的 定义 以 被 索引 数据 的 类 型 开始 。 类 型 是 模型 类 的 
名 称 。 

然后 , 开发 者 需要 声明 一 系列 要 索引 的 特性 ,以 及 它们 是 否 应 该 按照 升序 或 者 降序 排序 。 对 
于 我 们 的 查询 ， 下 面 是 一 个 索引 的 定义 : 
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indexes: 
- kind: ResourceAttribute 
properties: 
- name: name 
- name: type 
- name: value 
direction: asc 


这 些 代码 描述 的 是 ， 我 们 希望 索引 ResourceAttribute， 以 便 能 够 基于 type 和 name 特 性 进行 等 
式 比较 ， 并 且 对 value 做 不 等 式 比较 ， 通 过 索引 将 value 特 性 按照 升序 排列 。 就 是 这 样 ， 一 旦 该 
索引 在 app.yam] 文 件 中 声明 ， 并 且 部 署 了 该 应 用 程序 ， 它 会 对 已 经 在 数据 仓库 中 的 所 有 数据 生 
成 该 索引 ， 并 且 在 用 户 添 加 /或 者 更 新 数据 的 时 候 索 引 会 被 更 新 。 

开发 者 还 可 以 看 到 App Engine 为 正在 运行 的 应 用 程序 创建 了 什么 索引 。 如 果 开 发 者 进入 App 
Engine 的 应 用 程序 的 控制 面板 ， 那么 ， 有 一 个 条 目 用 来 检查 数据 仓库 的 索引 。 例 如 ， 对 于 Java 聊 
天 室 应 用 程序 ，PChatMessage 上 有 一 个 索引 ， 按 日 期 和 聊天 的 升序 排列 进行 索引 。 
























































14.1.4 ”Java 中 的 索引 


在 Java 中 , 数据 仓库 索引 几乎 与 其 在 Python 中 的 工作 方式 完全 相同 , 应 用 同样 的 规则 和 限制 ， 
并 且 两 者 非常 相似 。 然 而 有 一 个 区 别 。 在 Python 中 ， 当 需要 创建 自 定义 索引 时 ， 我 们 通过 在 定义 
Python 应 用 程序 的 app.yam1 中 添加 表 项 来 实现 。 但 是 ， 在 App Engine 中 运行 的 Java 应 用 程序 并 没 
有 app.yam1 文 件 。 在 Java 中 ， 开 发 者 需要 使 用 一 个 不 同 的 文件 ， 采 用 的 是 一 个 名 为 
datastore-indices.xm] 的 文件 。 正 如 开发 者 所 看 到 的 ， 这 是 一 个 XML 文件 。 

我 听 到 过 很 多 人 抱怨 不 得 不 使 用 像 XML 一 样 很 复杂 的 内 容 ， 而 不 是 Python 中 轻 量 级 的 
YAML。 就 我 个 人 而 言 ， 我 更 喜欢 XML 文件 。YAMIL 文 件 的 语法 相当 古怪 。 我 总 是 觉得 很 难保 证 
其 语法 正确 ， 可 能 很 难 知道 什么 时 候 可 以 添加 另 一 个 “-” ， 以 及 什么 时 候 开 始 一 个 没有 破 折 号 的 
新 行 。 我 根本 不 想 弄 明白 它 的 正确 用 法 。XML 可 能 有 点 丑陋 ， 而 且 体 积 有 可 能 会 比 必 要 代码 多 
一 倍 。 但 是 XML 很 清晰 ， 很 容易 弄 明 白 各 部 分 的 功能 。 

针对 之 前 在 Python 中 创建 的 索引 ， 可 以 使 用 下 面 的 XML 为 Java 创 建 相 同 的 索引 : 















































filesystem/datastore-indexes.xml 


<?xml version="1.0" encoding="utf-8"?> 
<datastore-indexes 
autoGenerate="true"> 
<datastore-index kind="ResourceAttribute" ancestor="false"> 
<property name="name" direction="asc" /> 
<property name="value" direction="desc" /> 
</datastore-index> 
</datastore-indexes> 


14.2 ”更 灵活 的 模型 
数据 仓库 中 发 生 的 另 一 件 重要 的 事情 就 是 模型 限制 。 我 们 到 目前 为 止 建立 的 模型 已 经 承受 了 
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很 多 的 限制 。 类 型 的 每 个 实例 都 必须 有 完全 相同 的 特性 , 采用 标准 模型 根本 没有 灵活 性 。 但 是 有 
时 候 ， 标 准 模型 限制 性 太 强 。 当 发 生 这 种 情况 时 ， 开 发 者 有 两 个 选择 来 解决 该 问题 : expando 模 
型 和 聚合 模型 (polymodels )。 
expando 模 型 是 开发 者 可 以 在 任何 时 候 给 模型 实例 任意 添加 新 的 特性 的 模型 。 它 基本 上 是 模 
型 灵活 性 的 极端 情况 。 开 发 者 可 以 在 任何 想 要 的 时 候 ， 添 加 任何 需要 的 内 容 。 模 型 的 所 有 实例 ， 
即 开 发 者 存储 的 所 有 的 对 象 ， 需 要 是 相同 Python 类 的 实例 。 

而 在 聚合 模型 中 , 开发 者 可 以 为 模型 实例 定义 一 个 超 类 。 然后 , 开发 者 可 以 添加 该 类 的 子 类 。 
当 进 行 查 询 时 ， 会 检索 聚合 模型 基 类 以 及 聚合 模型 子 类 的 所 有 实例 。 

开发 者 使 用 expando 模 型 或 聚合 模型 之 前 ,请 静 下 心 来 想 一 想 。 根 据 我 的 经 验 ， 大 多 数 时 候 ， 
如 果 开 发 者 不 能 使 用 聚合 模型 或 者 expando 模 型 简洁 地 定义 其 模型 ， 那 说 明 开 发 者 还 没有 把 事 : 
想 得 足 够 清楚 。 有 些 情况 下 ,开发 者 可 能 需要 使 用 灵活 的 模型 ， 但 是 的 确 需要 时 ， 这 两 个 模型 是 
现成 可 用 的 。 对 expando 模 型 尤其 如 此 : expando 模 型 的 极端 灵活 性 有 点 像 流程 控制 中 goto 语 句 的 
超级 灵活 性 。 这 种 灵活 性 比较 适合 解决 某 些 问题 ， 但 在 有 些 情况 下 ,用 它 来 解决 虽然 简单 ， 却 并 
不 正确 。 

在 采用 聚合 模型 的 情况 下 , 内容 非 常 清晰 。 开 发 者 用 与 定义 标准 模型 完全 相同 的 方式 定义 一 
个 模型 类 ， 只 是 该 基 类 是 从 polymode1 .PolyMode1 继 承 的 。 然 后， 开发 者 再 按照 通常 的 方式 定 
义 聚 合 模型 的 子 类 。 

例如 ， 我 们 可 以 以 文件 系统 为 例 ， 使 ResourceAttribute 成 为 聚合 模型 添加 类 型 属性 。 然 
后 ， 就 可 以 为 字符 串 属 性 、 整 数 属性 等 添加 ResourceAttribute 的 子 类 : 
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filesystem/poly.py 
class ResourceAttribute(polymodel .PolyModel): 


name = db.StringProperty(required=True) 


class StringAttribute(ResourceAttribute): 
strVal = db.StringProperty(required=True) 


class IntegerAttribute(ResourceAttribute): 
intVal = db.IntegerProperty(required=True) 


如 果真 的 必须 要 用 expando 模 型 , 也 是 非常 简单 的 , 从 google.appengine.ext.db.Expando 
继承 类 即 可 。 在 expando 模 型 中 ， 开 发 者 根本 不 需要 定义 任何 特性 。 当 然 也 可 以 定义 一 组 固定 特 
性 ， 这 些 特性 会 被 包含 在 该 模型 的 每 个 实例 中 ,但 同时 ，Python 对 象 的 各 个 字段 也 将 隐 式 地 被 视 
为 无 类 型 特性 。 采 用 这 种 方式 时 ,也 就 失去 了 数据 仓库 通常 所 提供 的 所 有 帮助 功能 。 开 发 者 不 会 
得 到 自动 引用 ， 也 不 会 得 到 任何 数据 验证 。Expando 模 型 是 完全 灵活 、 完 全 非 结 构 化 的 ， 人 们 可 
能 不 希望 使 用 它 。 我 曾 看 到 过 一 个 expando 模 型 的 例子 ， 确 实 是 需要 使 用 expando。 我 不 想 在 这 里 
向 读者 展示 这 样 的 例子 ， 因 为 那 毫 无 意义 。 

或 许可 以 定义 一 个 使 用 expando 模 型 的 文件 系统 版 本 。 我 能 完全 消除 ResourceAttribute， 
而 只 使 用 Python 资源 对 象 的 字段 来 存储 特性 。 但 这 是 一 个 糟糕 的 解决 方案 ， 失 去 了 对 属性 定义 查 
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询 的 能 力 ， 以 及 很 多 结构 一 致 性 。 能 获得 什么 呢 ? 坦白 地 说 ， 没 有 多 少 。 对 于 更 新 属性 而 言 ,， 我 
能 够 获得 稍微 好 一 点 的 语法 ， 收 获 仅 限于 此 。 


14.3 事务、 关键 字 和 实体 组 


回顾 10.2 节 ， 我 们 谈 到 了 事务 。 它 们 为 何如 此 重要 ? 它们 在 Java 中 又 是 怎样 自动 工作 呢 ? 原 
来 , 我 们 在 Python 中 也 一 直 在 用 事务 , 只 是 没有 费心 去 了 解 它们 而 已 。 与 使 用 Python 的 App Engine 
中 的 许多 其 他 工作 一 样 ， 默 认 行 为 已 经 设置 好 了 ， 而 且 大 部 分 时 候 ， 默 认 设置 就 是 正确 的 。 但 像 
往常 一 样 ,有 些 情况 下 开发 者 想 要 进行 的 并 不 是 缺 省 内 容 , 因此 需要 了 解 事务 究竟 是 如 何 工 作 的 。 

Python 中 的 事务 是 由 实体 组 ( entity group ) 驱动 的 。 开 发 者 在 Python 中 创建 的 每 一 个 持久 性 
对 象 ， 都 是 称 为 实体 组 的 对 象 组 的 一 部 分 。 每 次 开发 者 从 Python 中 往 数据 仓库 存储 一 个 更 改 时 ， 
对 同一 个 实体 组 的 对 象 的 所 有 更 改 将 在 一 个 事务 中 保存 。 因 此 , 如 果 开 发 者 可 以 将 其 所 要 存储 的 
所 有 内 容 安排 在 一 个 实体 组 中 ， 就 不 需要 担心 事务 了 ， 它 将 会 正常 工作 。 

实体 组 使 用 祖先 关系 进行 管理 , 每 个 对 象 都 自动 与 它 的 父 对 象 在 相同 的 实体 组 中 。 开 发 者 在 
创建 对 象 时 创建 父子 关系 ， 当 创建 一 个 持久 性 Python 对 象 时 ， 可 以 通过 使 用 一 个 命名 的 parent 
参数 指定 该 对 象 的 父 对 象 。 如 果 不 指定 父 对 象 ， 那 么 该 对 象 是 根 ， 它 定义 了 它 自己 的 实体 组 。 

如 果 开 发 者 不 需要 使 用 一 个 对 象 集合 内 的 事务 行为 , 那么 最 好 就 让 对 象 作为 根 。 事务 非常 有 
用 ， 但 代价 并 不 小 。 以 数据 仓库 和 App Engine 分 布 式 环境 来 看 ， 实 体 组 不 能 是 分 布 式 的 。 实 体 组 
需要 集中 位 于 一 台 服 务 器 上 。 这 意味 着 ， 当 开发 者 扩展 到 大 量 的 用 户 和 对 象 时 , 将 太 多 的 东西 放 
到 同一 个 实体 组 内 可 能 使 其 应 用 程序 的 执行 变 得 非常 糟糕 。 

例如 , 在 聊天 应 用 程序 中 , 我 们 可 以 将 所 有 的 聊天 消息 放 入 一 个 实体 组 中 。 这 样 做 会 有 一 定 
的 优势 ,如 提供 非常 强 有 力 的 一 致 性 保证 。 但 随 着 时 间 的 推移 ,我 们 很 容易 地 就 会 在 数 百 个 聊天 
室 中 拥有 数 万 或 数 十 万 个 聊天 消息 , 并 且 在 事务 进行 过 程 中 , 向 任何 聊天 室 添 加 消息 都 会 阻止 其 
他 聊天 室 用 户 的 更 新 。 

另 一 方面 , 我 们 也 不 想 忽略 事务 的 价值 。 在 文件 系统 中 , 如 果 用 户 更 新 一 个 资源 的 一 组 属性 ， 
然后 保存 ,用户 必然 期 望 更 新 或 者 成 功 ， 或 者 失败 。 所 以 , 在 我 们 的 文件 系统 资源 的 例子 中 , 使 
属性 成 为 资源 的 子 节点 是 有 意义 的 , 从 而 使 属性 更 新 成 为 它们 的 父 对 象 的 事务 的 一 部 分 。 要 实现 
这 些 功 能 ， 我 们 唯一 需要 做 的 修改 是 Resource 的 SetAttribute 方 法 : 
















































































































































































filesystem/filesystem_servlet.py 


def SetAttribute(self, name, value): 
if name == "children": 
self.children = [ de.key() for de in value ] 
self.put() 
else: 
for attr_key in self.attributes: 
attr = ResourceAttributeModel.get(attr_key) 
if attr.name == name: 
attr.value = value 
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attr.putO 
return 
newAttr = ResourceAttribute(parent=self, name=name, value=value) 
newAttr .put() 
self.attributes.append(newAttr.key()) 
self.put() 


这 个 代码 与 我 们 以 前 见 过 的 setAttribute 方 法 之 间 的 唯一 区 别 是 创建 新 的 ResourceAttribute 
对 象 的 调用 。 在 这 个 新 版 本 中 ， 我 们 为 ResourceAttribute 提 供 了 一 个 parent 人 参数 ， 将 属性 放 
到 与 Resource 对 象 本 身 相 同 的 资源 组 中 。 

除了 事务 ， 资 源 组 也 影响 了 对 象 关键 字 。 关 键 字 编 码 了 资源 路 径 的 信息 ， 即 从 根 对 象 到 特定 
对 象 的 绝对 路 径 。 这 个 特点 可 以 用 在 查询 中 , 开发 者 可 以 借 此 缩小 查询 范围 , 使 查询 中 只 包括 特 
定 对 象 作 为 祖先 的 对 象 。 通 过 在 查询 中 使 用 一 个 特殊 的 查询 子 句 ANCESTOR IS 可 以 实现 此 功能 。 
例如 ， 在 文件 系统 中 ,属性 有 资源 作为 父 节点 ， 从 而 ,我 们 可 以 查询 一 个 特定 资源 的 属性 值 。 如 
果 想 要 资源 R 的 length 属 性 ， 我 们 可 以 写 一 个 类 似 下 面 的 GQL 查 询 : 


query = db.GqlQuery("SELECT * FROM ResourceAttribute WHERE " 
"name = :name AND ANCESTOR IS :parent", 
name="1length", parent=R.keyQO)) 


14.4 ”策略 和 一 致 性 模型 


我 们 需要 学 习 的 有 关 数 据 仓 库 的 最 后 一 个 内 容 涉 及 策略 ( policy ) 这 个 概念 。 策 略 是 描述 定 
义 系统 该 如 何 执行 的 高 层次 选项 的 总 称 。 在 数据 仓库 中 , 哪些 索引 集会 自动 生成 就 是 一 个 策略 问 
题 。 有 两 个 主要 策略 问题 会 影响 开发 者 可 以 控制 的 数据 仓库 查询 。 

口 一 致 性 模型 : 系统 处 理 在 App Engine 云 中 运行 的 应 用 程序 的 不 同 实例 之 间 的 一 致 性 方法 。 

毫 无 疑问 ， 一 致 性 策略 是 最 关键 的 策略 问题 。 我 们 后 面 将 介绍 更 多 的 内 容 。 

口 截止 期 限 : 查询 失败 之 前 应 该 允许 耗费 的 最 大 时 间 。 有 时 候 , 根本 就 等 不 起 某 些 内 容 
如 果 在 特定 时 段 内 没有 产生 响应 ， 就 根本 没有 生成 的 必要 了 。 例如， 在 聊天 应 用 程序 中 ， 
如 果 响 应 更 新 查询 的 时 间 超 过 了 1 秒 钟 ， 就 没有 响应 的 机 会 了 ， 因 为 男 一 个 更 新 请 求 已 经 
被 放 入 队列 中 一 一 如 果 每 个 查询 时 间 超 过 两 次 查询 间 的 时 间 ， 就 会 造成 不 断 增长 的 查询 
积压 。 让 查询 失败 并 返回 , 比 生 成 一 个 不 断 增 长 的 积压 要 好 得 多 ! 截止 期 限 表达 的 是 :“ 如 
果 这 花费 了 太 长 时 间 ， 那 就 让 它 失 败 ， 而 不 是 等 待 。” 

如 上 所 述 , 最 重要 的 策略 问题 涉及 一 致 性 模型 。 默认 情况 下 ,数据 仓库 采用 所 谓 的 强 一 致 性 
模型 。 强 一 致 性 是 指 进行 相同 查询 的 任何 两 个 客户 端 ,总 是 保证 得 到 相同 的 结果 。 这 似乎 是 一 个 
显而易见 的 需求 : 如 果 一 个 给 定 的 查询 并 不 总 是 产生 相同 的 结果 ， 一 定 有 错误 ， 不 对 吗 ? 

不 一 定 。 如 果 数 据 是 静态 的 ,那么 任何 查询 会 得 到 一 个 精确 的 、 定 义 良好 的 结果 ， 并且 每 一 
个 查询 总 是 返回 该 结果 。 但 是 ,更 新 会 使 其 复杂 化 。 结 果 的 定义 需要 考虑 特定 的 时 间 。 然而, 正 
如 我 们 讨论 过 的 ,分布 式 环境 中 的 时 间 有 些 棘 手 。 

想象 如 下 的 场景 。 
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(1) 客户 端 1 获取 资源 R1， 并 将 属性 A 设 置 为 字符 串 abc。 

(2) 客户 端 2 获 取 资 源 R1。 

(3) 客户 端 1 将 R1 的 属性 A 更 新 为 字符 串 def。 

(4) 客户 端 2 获取 R1 的 属性 A。 

客户 端 2 获 得 的 R1 的 属性 应 该 是 什么 值 呢 ? 

根据 强 一 致 性 , 它 应 该 得 到 def。 属 性 被 更 新 了 ,客户 端 1 看 到 了 更 新 , 因此 所 有 其 他 客户 端 
也 必须 看 到 更 新 。 对 于 许多 应 用 程序 ， 这 正 是 开发 者 想 要 的 结果 。 例 如， 如 果 你 正在 运行 网 上 商 
店 ， 并 告诉 用 户 还 剩 一 个 商品 ， 你 不 想 将 此 商品 出 售 两 次 : 一 且 任 何人 购买 了 该 商品 ， 现 在 该 商 
品 库存 为 零 的 事实 应 立即 对 所 有 人 可 见 。 强 一 致 性 保证 了 这 点 。 用 行业 术语 说 ， 强 一 致 性 是 保守 
的 ， 它 确保 总 是 向 每 个 人 提供 正确 的 结果 ， 不 管 成 本 多 大 。 

但 强 一 致 性 代价 确实 很 高 。 在 我 们 的 例子 中 , 客户 端 2 在 客户 端 1 进行 更 新 之 前 进行 了 资源 的 
完整 取 回 操作 。 如 果 客 户 端 2 要 看 到 属性 的 更 新 值 ， 它 需要 给 服务 器 发 送 新 的 查询 ， 通 过 引用 取 
回 属性 。 客 户 端 2 不 能 一 次 就 获取 所 有 内 容 。 这 一 轮 行程 不 是 免费 的 ， 有 显著 的 成 本 。 有 时候， 
这 样 的 花费 是 不 值得 付出 的 。 

还 有 另 一 种 一 致 性 政策 , 称 为 最 终 一 致 性 , 代价 会 低 一 些 。 在 最 终 一 致 性 中 , 发 生 的 情况 是 ， 
最 终 , 各 部 分 将 对 数据 的 值 达 成 一 致 。 但 也 有 可 能 在 一 个 短 的 时 间 内 ,各 部 分 数据 并 不 一 致 。 换 
句 话 说， 这 是 一 种 模糊 一 致 性 : 每 当 用 户 做 一 个 更 新 时 ， 有 一 个 模糊 的 时 期 有 人 可 能 会 看 到 旧 
的 、 未 更 新 的 值 。 

对 于 数据 库 领 域 ,最 终 一 致 性 被 称 为 BASE 一 致 性 ( Basically Available, Soft State ,with Eventual 
consistency )， 对 应 ACID ( Atom，Consistent，Isolated, Durable state )。 

最 终 一 致 性 对 很 多 工作 而 言 都 很 好 。 例 如 ,在 聊天 室 例子 中 ,最 终 一 致 性 可 能 意味 着 两 个 不 
同 的 客户 端 在 最 后 一 条 消息 发 布 时 不 一 致 。 但 是 由 于 客户 端 1 秒 通过 查询 检查 两 次 ， 所 以 他 们 的 
不 一 致 时 间 绝 不 会 超过 半 秒 ! 对 于 聊天 室 而 言 ， 这 完全 是 可 接受 的 。 

同样 ,对 于 文件 系统 ， 人 们 普遍 认可 如 果 两 个 程序 试图 在 同一 时 间 修 改 同一 个 文件 , 结果 可 
能 会 出 错 。 如 果 开 发 者 使 用 最 终 一 臻 性， 可 能 在 涉及 属性 值 等 的 地 方 获得 竞争 条 件 , 但 是 ， 有 多 
个 客户 端 并 发 更 新 属性 值 ， 难 免 会 出 现 竞争 条 件 。 强 一 致 性 减 慢 了 速度 ， 并 消除 了 一 些 竞 争 , 但 
并 不 是 全 部 竞争 。 

所 以 , 假设 我 们 要 在 查询 中 使 用 最 终 一 致 性 , 该 查询 返回 的 结果 也 许 稍 有 过 时 , 但 我 们 明白 
并 且 对 此 可 以 接受 。 我 们 如 何 真 正 使 用 最 终 一 致 性 呢 ? 
事实 上 ， 必 须 一 直 分 析 到 数据 仓库 接口 的 底层 ， 才 能 弄 清 该 问题 。 在 底层 ， 数 据 仓 库 使 用 
Google 的 异步 RPC 系 统 ， 如 同 在 第 12 章 中 所 见 到 的 那样 ， 我 们 需要 修改 查询 中 使 用 的 RPC 的 内 部 
参数 。 策 略 问题 是 由 RPC 对 象 决 定 的 ， 因 此 ， 我 们 要 改变 策略 ， 就 需要 改变 RPC 对 和 象 。 
查询 操作 Query 的 fetch 方 法 ， 其实 需要 一 个 名 为 rpc 的 参数 。 它 用 默认 的 参数 值 定义 , 能够 
用 标准 参数 创建 了 一 个 新 的 RPC 对 象 。 当 开发 者 想 改变 策略 的 功能 时 ， 需 要 用 正确 的 策略 参数 创 
建 自己 的 RPC 对 象 。 

开发 者 可 以 通过 调用 db.create_rpc 创 建 RPC 对 象 。 该 函数 需要 两 个 命名 参数 : read_policy 
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和 dead1ine。 要 使 用 最 终 一 致 性 ， 请 设置 read_po1icy = db.EVENTUAL_CONSISTENCY。 开 发 者 不 需要 
声明 强 一 致 性 ， 但 如 果真 的 想 要 用 强 一 致 性 ， 那 么 可 以 使 用 read_po1icy = db.STRONG_CONSISTENCY 
显 式 地 设置 默认 值 。 对 于 dead1ine， 该 参数 的 值 表示 在 查询 失败 之 前 想 要 等 待 的 最 低 秒 数 。 和 截止 时 
间 过 后 ， 并 不 保证 它 会 立即 失败 ， 唯 一 可 以 保证 的 是 不 会 在 截止 时 间 前 失败 。 

开发 者 创建 好 一 个 RPC 对 象 之 后 ， 可 以 将 它 作 为 查询 的 参数 。 因 此 ， 举 例 来 说 ， 如 果 q 是 开 
发 者 的 查询 ， 那 么 可 以 用 此 代码 实现 使 用 截止 时 间 为 2 秒 的 最 终 一 致 性 : 















































my_rpc = db.create_rpc(deadline=2, read_policy=db.EVENTUAL_CONSISTENCY) 
result = q.fetch(rpc=my_rpc) 





同样 ， 如 果 开 发 者 使 用 Python 迭代 需 访 问 查 询 的 结果 , 那么 可 以 在 run 方 法 中 提供 RPC 对 象 ， 
而 不 是 fetch 方 法 中 : 


my_rpc = db.create_rpc(deadline=2, read_policy=db.EVENTUAL_CONSISTENCY) 
for r in q.runCrpc=my_rpc) : 




















当然 ， 正 如 在 许多 高 级 功能 中 一 样 : 仅仅 因为 你 可 以 这 样 使 用 ， 并 不 意味 着 你 应 该 这 样 做 。 
大 多 数 时 候 ， 开 发 者 最 好 进行 fetch 操 作 ， 因 为 fetch 更 高 效 。 

在 Java 中 的 过 程 是 相似 的 , 但 开发 者 不 用 显 式 地 使 用 RPC 对 象 相反 ,App Engine 使 用 的 JDO 
API 提 供 了 对 查询 对 象 直接 设置 策略 的 方法 。 该 方法 并 不 是 创建 一 个 由 策略 设置 的 RPC 对 象 ， 然 
后 将 其 传递 给 查询 方法 ,而 是 开发 者 可 以 直接 在 查询 对 象 上 设置 策略 : 


Query q = persister.newQuery(ChatMessage.class); 
q.addExtension("datanucleus.appengine.datastoreReadConsistency", "EVENTUAL"); 
q.setTimeoutMi11is(2000) ; 


14.5 渐进 式 取 回 


默认 情况 下 ,开发 者 在 数据 仓库 中 做 查询 时 ,一 次 返回 该 查询 的 所 有 结果 。 在 性 能 方面 ， 这 
通常 是 最 好 的 选择 : 这 样 可 能 在 大 多 数 情 况 下 提供 最 佳 的 运行 时 性 能 。 但 有 时 , 一 个 查询 会 返回 
大 量 数据 , 难以 一 次 在 内 存 中 保存 。 所 以 , 开发 者 需要 将 查询 策略 改变 为 以 组 块 为 单位 访问 数据 。 

查询 的 工作 方式 是 全 部 获取 还 是 渐进 式 ( 即 一 个 组 块 接 着 一 个 组 块 ) 获取 , 确实 是 个 策略 问 
题 。 但 坦率 来 说 , 它 要 比 我 们 所 见 的 一 致 性 策略 获得 的 支持 更 好 。 各 种 不 同 的 一 致 性 模型 的 支持 
非常 草率 。App Engine 的 设计 者 很 自然 地 认为 强 一 致 性 几乎 总 是 正确 的 。 于 是 ， 他 们 特意 让 最 终 
一 致 性 使 用 起 来 显得 有 些 笨拙 。 开 发 者 需要 三 思 自 己 确 实 想 要 使 用 最 终 一 致 性 ,因为 使 用 最 终 一 
致 性 非常 痛苦 。 但 渐进 式 查询 呢 ? 这 是 非常 直观 的 功能 ， 因 此 渐进 式 查询 功能 的 支持 更 稳定 。 

对 于 渐进 式 查 询 ， 需 要 使 用 游标 (cursor )。 由 开发 者 进行 查询 , 但 是 查询 时 ,会 对 查询 应 该 
返回 的 结果 数量 有 所 限制 。 然 后 , 开发 者 可 以 对 内 容 进 行 正常 迭代 。 因 为 做 了 一 个 有 限制 的 取 回 
操作 ， 所 以 ， 开 发 者 现在 会 有 一 个 游标 ， 指 向 其 已 经 取 回 的 结果 后 边 的 第 一 个 查询 结果 的 位 置 。 

要 进行 有 限制 的 查询 ,开发 者 只 要 向 查询 语句 提供 一 个 数字 参数 即 可 。 例 如， 要 对 所 有 资源 
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对 象 做 查询 ， 但 每 次 只 取 回 50 个 ， 可 以 使 用 有 限制 的 查询 : 


q = Resource.allQO 
batch = 9q.fetch(50) 


然后 ， 开 发 者 完成 首 批 迭代 后 ， 就 可 以 通过 调用 q.cursor() 得 到 该 查询 的 游标 。 
对 于 下 一 批 查询 ， 接 下 来 开发 者 可 以 按照 如 下 代码 设置 游标 ， 并 使 用 该 游标 : 
q = Resource.allQO 


batch = q.fetch(50) 
c= q.cursorQ 














q.with_cursor(c) 
q.fetch(50) 


每 一 批 查询 之 后 ， 开 发 者 都 可 以 从 查询 对 象 上 获取 游标 。 然 后 ,在 做 下 一 个 查询 时 ， 就 可 以 
向 其 提供 游标 ， 作 为 查询 的 起 点 。 事 实 上 ， 游 标本 身 能 够 被 用 作 持 和 久 性 对 象 : 开发 者 可 以 保存 一 
个 游标 ， 然 后 在 以 后 的 查询 中 使 用 。( 在 下 一 章 中 学 习 Memcache 服 务 时 ， 这 将 变 得 特别 有 用 。 ) 

在 过 去 的 两 章 中 ， 我 们 已 经 了 解 了 App Engine 数 据 仓 库 中 的 一 些 更 高 级 的 功能 以 及 局 限 性 。 
不 过 ,这 些 还 只 是 表面 文章 。 数 据 仓库 在 不 断 发 展 , 将 来 会 提供 更 多 更 好 的 功能 ， 所 以 开发 者 一 
定 要 时 常 查看 App Engine 的 文档 。 但 其 主要 功能 和 关键 的 设计 要 点 ， 都 会 保持 不 变 。 

正如 我 们 所 看 到 的 , 数据 仓库 的 真正 秘密 是 要 能 理解 它 所 采用 的 基本 模式 。 这 是 一 个 用 于 存 
储 对 象 的 系统 ,一切 其 他 事情 一 一 从 事务 系统 到 查询 语言 ， 到 关键 结构 ， 到 引用 一 一 都 是 从 基本 
的 原则 派生 而 来 的 。 数据 仓库 就 是 有 关 如 何 存 储 持久 性 对 象 的 一 一 存储 的 不 是 表 、 不 是 集合 、 不 
是 列表 ， 也 不 是 树 。 

App Engine 数 据 仓库 是 一 个 灵活 的 、 轻 量 级 的 、 基 于 对 象 的 持久 性 机 制 ， 而 不 是 一 个 关系 数 
据 库 。 如 果 开 发 者 记 住 了 这 一 点 ， 就 会 发 现 数据 仓库 通常 是 以 很 直观 的 方式 运行 的 。 































































































Google App Engine 服 务 























现代 软件 工程 的 主要 关注 点 之 一 是 重用 。 我 们 不 希望 不 断 地 重新 开发 同样 的 东西 。 对 于 最 
常见 的 软件 组 件 ， 我 们 创建 包含 组 件 实现 的 库 ， 然 后 只 要 使 用 这 些 库 即 可 ， 而 不 用 再 编写 自己 
的 实现 代码 。 例 如 ， 在 C++ 中 ， 并 不 会 在 每 次 构建 用 到 哈 希 表 的 应 用 程序 时 都 编写 一 个 新 的 哈 
和 希 表 实现 ,我 们 只 需 使 用 标准 模板 库 中 的 映射 类 型 即 可 。 在 Python 应 用 程序 中 建立 用 户 界 面 时 ， 
并 不 是 从 编写 用 单个 像素 绘制 按钮 的 代码 开始 ， 而 是 找到 一 个 像 wxwindows 这 样 的 库 ， 然 后 使 
用 已 有 的 库 。 

云 中 做 法 也 几乎 相同 , 只 是 不 使 用 库 , 而 是 使 用 服务 。 库 和 服务 之 间 的 区 别 是 微妙 而 重要 的 。 
库 (library ) 是 静态 的 ， 它 是 计算 机 上 拥有 的 一 堆 代 码 ， 我们 可 以 在 应 用 程序 里 包含 库 。 使 用 库 
时 ， 库 的 代码 成 为 我 们 的 应 用 程序 的 一 部 分 。 在 云 的 世界 中 ， 服 务 ( service ) 是 在 云 中 某 处 运行 
的 ， 它 本 质 上 是 应 用 程序 本 身 ， 但 是 ， 该 应 用 程序 的 运行 是 为 了 向 其 他 应 用 程序 提供 某 种 能 

服务 对 于 我 们 而 言 并 不 是 全 新 的 。 在 之 前 的 几 章 中 , 我 们 一 直 在 详细 地 了 解数 据 仓库 ， 而 数 
据 仓 库 就 是 App Engine 提 供 的 服务 之 一 。 在 第 5 章 中 ， 我 们 还 看 到 了 另 一 个 用 于 管理 用 户 登 录 的 
App Engine 服 务 。 

我 们 有 很 多 标准 桌面 开发 的 库 ， 可 以 提供 给 应 用 程序 其 可 能 需要 的 不 同 功能 的 实现 ， 同 样 ， 
云 中 (特别 是 在 App Engine 中 ) 有 很 多 服务 ， 可 提供 给 云 应 用 程序 所 需 的 各 种 功能 。 本 章 将 讨论 
App Engine 提 供 的 通用 服务 的 集合 ， 但 不 会 巨细 摩 遗 地 加 以 介绍 ， 因 为 用 于 App Engine 开 发 的 服 
务 有 很 多 ， 而 且 Google 的 App Engine 团 队 还 在 不 断 地 扩大 他 们 所 提供 的 服务 集 。 我 们 将 列举 一 些 
服务 的 例子 ， 从 而 让 读者 进一步 了 解 服务 所 提供 的 功能 以 及 服务 接口 的 工作 原理 。 

本 音 稍 显 芜 杂 。App Engine 提 供 了 大 量 服务 ， 而 且 其 中 大 部 分 服务 都 很 简单 ， 而 且 也 非常 杂 
乱 , 不 需要 花费 一 整 章 对 每 一 服务 进行 细致 的 介绍 。 读 者 可 能 会 在 需要 之 时 才 从 本 章 中 抽取 相应 
的 服务 。 


15.1 快速 访问 重要 内 容 : Memcache 服务 


Memcache 可 能 是 开发 者 在 实际 的 应 用 程序 中 使 用 最 多 的 服务 之 一 一 一 它 非 常 简 单 ， 只 需要 
一 两 段 话 就 能 说 清 。 创 建 的 每 个 App Engine 应 用 程序 都 会 将 数据 存储 在 数据 仓库 中 。 但 问题 是 ， 
从 数据 仓库 取 回 东西 需要 时 间 。 当 你 第 一 次 考虑 取 回 操作 所 花费 的 时 间 时 ,似乎 微不足道 一 一 通 
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常 只 有 不 到 一 秒 钟 而 已 。 但 如 果 设 想 一 下 有 可 能 一 秒 钟 要 提供 数 千 个 请 求 的 真实 服务 时 , 这 些 取 
回 操作 时 间 加 起 来 就 会 变 得 不 容 忽 视 。 

对 于 Memcache 的 名 称 ， 开 发 者 丝毫 不 会 惊讶 ， 该 名 称 正 表示 其 所 提供 的 功能 : 内 存 中 的 组 
存 。 开 发 者 会 一 直 在 数据 仓库 中 保存 其 数据 的 主 副 本 。 但 同时 也 会 在 Memcache 中 存放 一 个 副本 ， 
而 且 只 要 数据 副本 存在 于 Memcache 中 ， 取 回 操作 实际 上 就 是 即时 的 。 

Memcache 是 简单 服务 的 一 个 很 好 的 例子 。 它 通过 一 个 简单 的 库 API 提 供 其 功能 。 在 后 台 , 它 
实现 了 一 些 很 微妙 的 工作 ， 从 而 提供 一 个 高 速 缓存 ， 能 够 从 App Engine 云 中 的 机 器 进行 访问 ,但 
是 ， 所 有 这 些 对 于 作为 客户 端的 用 户 而 言 ， 都 是 不 可 见 的 。 该 服务 有 一 组 功能 ， 只 有 开发 者 可 以 
调用 ， 看 起 来 就 像 一 个 简单 的 内 存 缓存 。 这 是 一 个 非常 优雅 且 十 分 有 用 的 小 服务 。 

当然 ，Memcache 还 有 一 些 要 注意 的 地 方 。 首 先 ， 它 是 易 失 性 存储 ， 无 法 保证 开发 者 已 存储 
在 Memcache 中 的 内 容 稍 后 还 会 存在 。Memcache 能 让 操作 变 快 ， 但 不 能 替代 如 数据 仓库 那样 的 非 
易 失 性 存储 。 如 果 开 发 者 一 段 时 间 内 不 访问 高 速 缓存 中 的 对 象 ， 或 者 开发 者 放 在 缓存 中 的 东西 太 
多 了 ， 用 完了 Memcache 的 空间 ， 就 会 开始 丢弃 缓存 的 内 容 。 每 当 开 发 者 使 用 Memcache 时 ， 都 需 
要 包含 一 个 对 数据 仓库 的 回调 函数 。 不 要 以 为 只 要 在 Memcache 中 放 入 内 容 ， 你 就 可 以 自动 取 回 
该 内 容 ! 

其 次 ，Memcache 是 用 于 存放 小 东西 的 。 开 发 者 发 送 到 Memcache 的 任何 请 求 最 大 为 1 兆 字 节 。 
所 以 ， 开 发 者 不 能 存储 大 于 1 兆 字 节 的 内 容 ， 如 果 要 用 一 个 单一 的 请 求 (无论 是 get 还 是 put ) 访 
问 多 个 对 象 ， 它 们 的 总 大 小 也 不 能 超过 1 兆 字 节 。 

因此 ， 举 例 来 说 ， 如 果 想 在 我 们 的 聊天 应 用 程序 中 使 用 Memcache， 就 不 能 用 它 实 现 对 所 有 
聊天 消息 列表 的 快速 访问 ， 聊 天 消息 列表 很 容易 会 增长 到 1 兆 字 节 以 上 。 但 是 ， 可 以 用 它 来 存储 
所 有 可 用 的 聊天 室 列表 : 按照 我 们 的 设置 方式 ， 聊 天 室 列 表 永 远 不 会 大 于 1 兆 字 节 。 































































































15.1.1 在 Python 中 使 用 Memcache 


在 Python 中 ，Memcache 基 本 上 是 一 个 简单 的 包含 键 / 值 对 的 字典 。 开 发 者 可 以 用 一 个 以 字符 
串 作 值 的 键 把 对 象 放 到 其 中 。 在 Python 中 ， 可 以 采用 类 似 下 面 的 代码 在 缓存 中 存储 对 象 : 


from google.appengine.api import memcache 











memcache.set(key="aString" value=aValue) 

而 且 ， 取 回 操作 也 很 简单 : 

Vv = memcache.get(key="aString") 
函数 get 会 返回 相应 的 值 ， 或 者 ， 如 果 关 键 字 不 在 缓存 中 ， 则 返回 None。 

开发 者 也 可 以 在 一 个 调用 中 进行 多 个 更 新 / 取 回 。 要 设置 多 个 值 , 使 用 set_multi, 并 传递 给 
该 函数 一 个 字典 作为 参数 : 

memcache.set_multi({ "keyl": "valuel", "key2": "value2"}) 

要 取 回 多 个 值 , 使 用 get_mu1ti, 并 传递 给 该 函数 一 个 键 列表 。 该 函数 返回 包含 键 / 值 对 的 字典 : 


dict = memcache.get_multi(["keyl", "key2"]) 
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最 后 , 正如 我 前 面 提 到 的 , 如 果 Memcache 一 段 时 间 不 被 访问 , 或 者 它 的 空间 用 完 , Memcache 
会 丢弃 内 容 。 开 发 者 可 以 通过 time 参 数 给 Memcache 提 示 ， 告 知 它 应 该 等 多 久 才 开 始 丢 弃 内 容 。 
这 个 时 间 参 数 的 意义 基本 上 等 于 告诉 它 “ 请 在 内 存 中 最 多 保留 该 内 容 这 么 长 时 间 ”。 当 然 ， 
Memcache 无 法 保证 会 将 数据 保留 那么 长 时 间 如 果 缓 存在 此 时 间 之 前 用 完了 可 用 空间 ， 仍 然 会 丢 
弃 该 值 。 但 Memcache 不 会 因为 该 内 容 太 久 没有 被 使 用 ， 在 指定 时 间 过 期 之 前 就 将 其 丢弃 。 该 时 
间 参 数 是 以 秒 数 来 计算 的 ， 因 此 ， 如 果 要 将 内 容 存储 至 少 两 个 小 时 ， 可 以 使 用 memcache .set 
(key="foo", value="bar", time=7200)。 





























15.1.2 ”在 Java 中 使 用 Memcache 


在 平常 的 App Engine 风 格 中 ， 涉 及 到 提供 给 Java 的 Memcache 访 问 功能 时 ，App Engine 是 基于 
标准 的 JavaAPI 构 建 的 。 有 一 个 在 Java 中 使 用 高 速 缓存 的 建议 标准 机 制 , 可 参见 Java 标 准 请 求 文档 
JSR107 的 描述 。App Engine 使 用 JSR107 的 API 提 供 了 从 Java 对 Memcache 的 访问 。 同 样 ， 作 为 标准 
过 程 的 一 部 分 而 设计 好 的 API 比 定制 化 设计 更 为 繁琐 。 因 此 ， 从 Java 中 使 用 Memcache 需 要 更 多 的 
样板 。 但 从 概念 上 说 ，Java 中 的 Memcache 与 我 们 在 Python 中 看 到 的 仍然 相同 。 事 实 上 ， 两 者 必须 
相同 ， 因 为 它们 有 着 相同 的 底层 实现 。 虽 然 表 面 API 不 同 ， 但 服务 却 完 全 一 样 。 高 速 缓存 就 是 从 
键 到 值 的 映射 。 在 Java 中 ， 值 需要 被 序列 化 ， 这 正 是 开发 者 要 把 数据 存放 到 数据 仓库 时 所 需要 的 
方式 。 在 此 之 前 , 我 们 看 到 , 在 Python 中 要 把 内 容 放 到 Memcache 中 , 可 以 只 进行 memcache .set。 
而 在 Java 中 ， 使 用 样板 ， 代 码 可 能 如 下 : 


import java.util.Map; 

import net.sf.jsr107.Cache; 

import net.sf.jsr107.CacheException; 

import net.sf.jsr107.CacheFactory ; 

import net.sf.jsr107.CacheManager ; 

import com.google.appengine.api.memcache.stdimp1.GCacheFactory ; 



























































class MyApplicationClass { 
Cache cache; 
Map cacheConfig = new HashMap() ; 


{ 
try { 
CacheFactory factory = CacheManager .getInstance() .getCacheFactory() ; 
cache = factory.createCache(cacheConfig); 
} catch (CacheException e) { 
// 不 用 担心 
} 
} 
cache.put(aKey, aValue); 
/AF nas 


} 
是 的 ， 与 Python 版 本 相 比 ， 这 段 代 码 有 点 见长 。 而 且 ， 由 于 使 用 了 无 类 型 映射 ， 该 代码 会 在 编译 
时 产生 一 个 敬告。 此外， 还 使 用 了 令 人 担忧 的 空 catch 子 句 。 不 过 别 害怕 。Map 参 数 采用 了 一 套 
特殊 实现 的 键 / 值 二 元 组 ， 然 而 ， 它 刻意 使 类 型 未 作 具 体 声明 ， 以 便 实现 过 程 中 可 以 使 用 其 想 要 
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的 任何 关键 字 和 值 。 在 App Engine 中 ， 开 发 者 总 会 得 到 一 个 缓存 实例 : CacheException 永 远 不 
会 被 CacheFactory 触 发 ， 所 以 开发 者 可 以 保留 空 的 catch 块 。 

只 要 开发 者 觉得 样板 不 碍 事 ， 它 就 变 得 像 在 Python 中 一 样 简 单 。 要 存储 一 个 对 象 ， 使 用 
cache.put， 而 要 取 回 对 象 ， 使 用 cache.get: 


cache.put("akey", aSerializableValue); 


value = (ValueType)cache.get(aSerializableValue); 

此 外 ,还 有 的 getA11 和 putA11 方 法 ， 其 使 用 就 像 Python 中 的 get_mu1ti 和 put_mul1ti。 
getA11 方 法 需要 一 个 键 的 集合 ， 返 回 键 / 值 二 元 组 的 映射 集合 ; putA11 需 要 键 / 值 的 二 元 组 映射 ， 
并 更 新 所 有 内 容 。 

不 幸 的 是 ， 开 发 者 用 来 从 Java 访 问 Memcache 的 JSR107 标 准 ， 不 允许 对 单个 对 象 设 置 缓存 过 
期 时 间 。 在 Java 中 ， 这 是 高 速 缓存 的 一 个 策略 特性 。 当 开发 者 得 到 缓存 时 ， 可 以 提供 配置 参数 ， 
其 中 之 一 就 是 缓存 过 期 时 间 。 因 此 ， 如 果 要 求 所 有 缓存 对 象 保留 至 少 两 个 小 时 左右 ， 在 创建 缓存 
时 ， 就 需要 给 特性 映射 添加 一 个 参数 : 

class MyApplicationClass { 

Cache cache; 


Map cacheConfig = new HashMap() ; 
cacheConfig.put(GCacheFactory .EXPIRATION_DELTA，3600) ; 

















try { 
CacheFactory factory = CacheManager .getInstance() .getCacheFactory() ; 
cache = factory.createCache(cacheConfig); 
} catch (CacheException e) { 
// 不 用 担心 
} 
} 
// 类 的 剩余 部 分 
} 


15.1.3 ”应 该 缓存 何 种 内 容 


Memcache 是 针对 少量 频繁 访问 内 容 的 易 失 性 存储 系统 。 不 要 只 想 把 一 切 内 容 自 动 都 转 存 到 
缓存 中 ， 必 须 谨 慎 上 且 有 选择 地 去 做 ， 只 有 当真 正 会 不 断 访问 某 些 内 容 时 ， 才 应 将 其 放 入 缓存 。 

例如 , 在 文件 系统 应 用 程序 中 ,每 个 请 求 都 需要 获取 根 目录 。 请 求 到 来 时 总 会 包含 我 们 想 要 
获取 或 者 更 新 的 资源 的 路 径 名 ， 为 了 找到 该 资源 ， 先 从 根 目录 资 源 开始 ,使 用 路 径 名 查找 特定 资 
源 (也 即 请 求 目标 )。 我 们 会 不 断 用 到 根 目 录 资 源 ， 因 而 该 内 容 应 在 Memcache 中 。 而 男 一 方面 , 我 
们 获取 的 一 个 典型 资源 可 能 不 该 在 Memcache 中 。 在 这 两 者 之 间 ， 正 是 事情 的 巧妙 之 处 : 层次 结 
构 中 低层 的 目录 将 会 被 比较 频繁 地 访问 ; 越 到 层次 结构 中 的 较 高 层 , 它们 可 能 被 取 回 的 频率 就 越 
小 。 在 文件 系统 的 例子 中 ， 高 层 的 目录 可 能 并 不 需要 被 缓存 。 

正如 之 前 所 提 到 的 那样 ,在 聊天 应 用 程序 例子 中 , 将 所 有 聊天 消息 放 到 缓存 中 毫 无 意义 , 但 
将 可 用 聊天 室 列表 保留 在 缓存 中 应 该 是 不 错 的 。 聊 天 室 对 象 很 小 ， 而 且 它 们 会 被 不 断 访问 。 
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15.1.4 缓存 访问 模式 


我 们 之 前 看 到 了 如 何 从 Memcache 中 取 回 东西 。 但 是 ， 因 为 Memcache 是 易 失 性 的 ， 要 查找 的 
值 可 能 不 在 其 中 ， 所 以 在 实际 应 用 中 ， 当 我 们 使 用 Memcache 时 ， 总 是 使 用 一 种 模式 取 回 值 : 首 
先是 尝试 缓存 ， 如 果 找 不 到 该 对 象 ， 就 回 到 数据 仓库 中 查询 。 

在 文件 系统 中 , 我们 实际 上 总 是 取 回 文件 系统 对 象 。 根 目录 资源 有 一 个 引用 特性 ， 所 以 看 起 
来 并 不 像 是 我 们 使 用 一 个 查询 语句 获取 了 根 目 录 。 真 正 的 查询 看 起 来 像 是 针对 文件 系统 对 象 的 ， 
然后 通过 访问 该 文件 系统 对 象 的 一 个 特性 来 获取 根 目 录 。 但 要 记 住 ,引用 特性 实际 上 是 自动 查询 。 
因此 ， 通 过 缓存 根 目录 ， 我 们 可 以 消除 两 个 查询 ! 

在 原始 版 本 的 FilesystemResourceHandler.get 中 , 我 们 通过 调用 getFilesystem 获 取 根 
对 象 ,该 函数 会 进行 一 个 GQL 查 询 取 回 文件 系统 对 象 , 然后 我 们 再 从 文件 系统 中 取 回 根 对 象 。 在 
Memcache 版 本 中 ， 代 码 改变 为 以 下 内 容 : 






















































































filesystem/cachedfilesystemservlet.py 


root = memcache.get(key="root") 
if root is None: 
query = Filesystem.gql("") 
filesystem = query.get(O) 
root = filesystem.getRoot() 
memcache.put("root", root) 


这 正 是 开发 者 会 一 次 又 一 次 地 使 用 Memcache 的 模式 。 首 先 ， 尝 试 从 缓存 中 取 回 该 对 象 ， 如 果 它 
不 存在 , 则 进行 一 个 数据 仓库 查询 以 取 回 该 对 象 , 然后 将 取 回 的 对 象 放 和 缓存。 接着 就 可 以 继续 
使 用 该 对 象 了 。 因 此 ， 如 果 对 象 在 高 速 缓存 中 ,开发 者 即刻 就 可 以 获取 ; 如 果 它 不 在 缓存 中 ， 需 
要 做 一 个 查询 并 取 回 对 象 ， 然 后 把 对 象 放 到 缓存 中 ， 以 便 在 下 一 次 需要 时 可 立即 获取 到 。 


15.2 ”访问 其 他 内 容 : URL Fetch 服务 


网 络 服务 和 应 用 程序 是 通过 HTTP 进 行 交 互 的 。 如 果 开 发 者 想 编写 一 个 与 其 他 网 络 服务 进行 
交互 的 应 用 程序 ， 就 需要 编写 发 送 HTTP 查 询 的 代码 。 由 于 这 是 很 常 做 的 工作 ，App Engine 提 供 
了 一 个 服务 ， 不 用 开发 者 手工 编写 HTTP 协 议 交 互 。 

事实 上 , Java 和 Python 都 提供 了 一 套 进 行 HTTP 交 互 的 标准 库 。 在 Python 中 , 有 三 种 不 同 的 库 : 
urllib 、urllib2 和 httplib 。Java ( 像 往常 一 样 ) 更 加 严格 ， 它 有 一 个 标准 的 HTTP 库 java.net. 
URLConnection。 开 发 者 可 以 按照 其 在 标准 的 Python 或 Java 中 的 方式 ， 在 App Engine 中 使 用 任何 
一 个 库 ， 但 是 ,在 后 台 ，App Engine 将 库 的 实现 替换 为 在 App Engine 环 境 中 优化 过 的 、 既 高 效 又 
可 扩展 的 定制 化 版 本 。 

因此 ， 如 果 我 们 的 文件 系统 服务 在 mcfile.appspot.com 运 行 ， 另 一 个 Python 应 用 程序 可 以 
使 用 下 面 的 代码 取 回 资源 markcc/book.htm]: 


import urllib 
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result = urlfetch.fetch("http://mcfile.appspot.com/markcc/book.html1") 
if result.status_code == 200: 
# 成 功 提 取 文 件 内 容 到 result.content 


要 知道 ， 像 云 应 用 程序 的 其 他 所 有 内 容 一 样 ， 开 发 者 要 对 所 使 用 的 资源 付费 。 在 App Engine 
中 ， 开 发 者 要 为 其 使 用 的 带宽 付费 ， 所 以 不 要 做 得 太 过 。 使 用 App Engine 编 写 某 些 程序 ， 如 网 络 
疏 虫 ， 成 本 可 并 不 低 。 


15.3 与 人 沟通 : Mail 和 Chat 服务 


除了 HTTP，App Engine 应 用 程序 或 服务 还 可 用 其 他 协议 来 跟 其 他 程序 沟通 。 例 如 ， 应 用 程 
序 可 能 会 用 即时 消息 向 用 户 发 送 警 报 。 虽 然 并 不 常见 ， 但 个 别 情况 确实 需要 如 此 。 

App Engine 提 供 了 一 个 能 让 应 用 程序 通过 即时 消息 与 用 户 交 互 的 服务 。 该 服务 非常 容易 ， 开 
发 者 不 必 担 心 究竟 要 使 用 什么 样 的 即时 消息 。 经 过 多 年 的 发 展 , 各 种 聊天 服务 已 经 商定 了 一 个 标 
准 的 描述 即时 消息 的 协议 ， 称 为 XMPP ( eXtensible Messaging and Presence Protocol， 可 扩展 通讯 
和 显现 协议 )。App Engine 提 供 的 服务 使 开发 者 可 以 使 用 XMPP 发 送 和 接收 聊天 消息 。App Engine 
对 所 有 的 XMPP 服 务 都 提供 一 个 标准 的 接口 通过 使 用 App Engine 的 XMPP 服 务 ， 开 发 者 可 以 与 
几乎 任意 使 用 该 标准 的 聊天 服务 的 用 户 沟 通 一 一 AIM、Google Talk，MSN Chat, 等 等 。( 在 后 台 ， 
作 虎 和 MSN Chat 使 用 专 有 协议 , 但 是 ,它们 都 有 XMPP 网 关 ， 这 意味 着 ,如果 开发 者 愿意 建立 与 
网 关 的 连接 ， 就 能 与 它们 交谈 。 ) 

XMPP 服 务 的 设置 方式 是 非常 典型 的 App Engine 处 理 通 信服 务 的 方式 。 各 种 服务 使 用 相同 的 
模式 让 开发 者 发 送 和 接收 电子 邮件 、 发 送 和 接收 存储 的 大 块 数据 、 接 收 排队 任务 的 通知 ,以 及 进 
行 其 他 工作 。 

为 了 发 送 邮 件 ，XMPP 提 供 了 一 个 对 象 ， 可 以 让 开发 者 使 用 方法 调用 执行 发 送 。 这 差不多 是 
目前 为 止 我 们 看 到 的 使 用 了 几乎 所 有 服务 的 接口 类 型 。 为 了 接收 消息 ，XMPP 提 供 了 一 个 HTTP 
门面 。 也 就 是 说 ， 它 得 到 传 入 的 消息 ， 并 作为 一 个 特定 URL 的 HTTP 请 求 呈现 给 开发 者 。 为 了 处 
理 收 到 的 消息 ， 开 发 者 只 需要 为 该 服务 的 传人 人 URL 实现 一 个 标准 的 HTTP 消 息 人 处 理 程序 ， 或 者 
servlet 即 可 。 这 看 起 来 似乎 有 点 奇怪 一 一 为 什么 要 获取 一 个 即时 消息 ， 并 将 它 变 成 一 个 HTTP 的 
POST 请 求 呢 ? 但 这 样 做 的 关键 是 ， 开 发 者 只 需要 知道 如 何 编写 一 种 处 理 程序 。 在 App Engine 中 ， 
开发 者 编写 的 处 理 传人 数据 的 所 有 内 容 都 是 HTTP 的 PUT 或 者 POST 处 理 程序 。 这 样 ， 开 发 者 只 需 
要 知道 一 个 接口 ， 只 需要 关心 一 种 处 理 程 序 。App Engine 称 这 种 功能 为 网 络 钩子 (webhook ): 在 
App Engine 中 ， 与 各 种 协议 和 服务 交互 的 能 力 都 通过 webhooks 提 供 ， 就 衍 佛 提供 了 一 座 桥 梁 ,， 将 
采用 其 他 协议 的 请 求 呈 现 为 好 像 使 用 的 是 HTTP 请 求 一 样 。webhooks 是 App Engine 最 出 色 的 功能 
之 一 ， 开 发 者 可 以 与 任何 服务 交互 ， 而 无 需 知道 其 采用 的 协议 的 细节 只 需要 编写 HTTP 的 
servlet 有 即 可 。 


15.3.1 ”发送 聊天 消息 
实际 上 ， 开 发 者 只 需 知道 两 种 方法 即 可 ， 一 个 用 于 检查 用 户 是 否 登 录 ， 一 个 用 于 发 送 消息 。 
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要 检查 用 户 是 否 登 录 ， 可 使 用 xmpp .get_presence。 因 此 举例 来 说 ， 要 检查 我 是 否 登 录 ， 然 后 
发 送 给 我 一 个 消息 ， 可 以 做 如 下 工作 : 


from google.appengine.api import xmpp 





if xmpp.get_presence("markccQ@gmail.com"): 
status_code = xmpp.send_message("markcc@gmail.com", "Hi Mark!") 
if status_code != xmpp.NO_ERROR: 
self.response.setStatus(500, "Sorry, couldn't send a message to Mark") 


或 者 ， 在 Java 中 : 


import com.google.appengine.api.xmpp.JID; 

import com.google.appengine.api.xmpp.Message; 

import com.google.appengine.api.xmpp.MessageBuilder; 
import com.google.appengine.api.xmpp.SendResponse; 
import com.google.appengine.api.xmpp.XMPPService; 

import com.google.appengine.api.xmpp.XMPPServiceFactory; 


class JavaXMPPExample { 


public sendMessage() { 
// 获取 一 个 表示 用 户 的 标识 符 对 象 
JID jid = new JID("example@gmail.com"); 
// 构建 消息 
Message msg = new MessageBuilder() 
.withRecipient]Jids(jid) 
.withBody("Hi Mark!) 
.buildQO; 
boolean messageSent = false; 
// 获取 XMPP 服 务 
XMPPService xmpp = XMPPServiceFactory.getXMPPServiceQ); 
// 检查 用 户 是 否 登录 
if (xmpp.getPresence(jid).isAvailable()) { 
// 发 送 消息 
SendResponse status = xmpp.sendMessage(msg); 
if ((status.getStatusMap().get(jid) != SendResponse.Status.SUCCESS)) { 
} 
} 


} 


像 往 常 一 样 ， ov 点 ， 需 要 为 用 户 创建 一 个 标识 对 象 ， 而 不 仅仅 是 直接 传递 一 
字符 串 。 但 同样 地 ， 这 只 是 样板 ， 0 然后 就 可 以 重用 。 


15.3.2 ”接收 即时 消息 


从 XMPP 接 收 消息 比 发 送 稍 微 难 一 些 , 但 其 实 也 非常 简单 。 对 于 App Engine 代 码 而 言 , XMPP 
只 不 过 是 一 种 使 用 HTTP 的 程式 化 方式 。 使 用 App Engine 的 webhook， 看 起 来 好 像 都 是 在 HTTP 之 
上 以 POST 形式 发 送 消 息 实现 的 。 无 需 担 心 XMPP 到 底 如 何 工作 ，App Engine 已 为 开发 者 处 理 好 了 
所 有 事情 。 开 发 者 需要 担心 的 就 是 如 何 处 理 App Engine 发 送 给 开发 者 的 HTTP 请 求 。 因 此 ， 要 想 
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让 应 用 程序 实现 从 XMPP 服 务 中 接收 XMPP 消 息 ， 只 需要 做 以 下 三 件 事 情 。 

(1) 告诉 App Engine 你 想 要 接收 XMPP 消 息 。 开 发 者 通过 在 其 应 用 程序 配置 文件 中 添加 一 个 表 
项 完成 该 工作 一 一 在 Python 中， 该 配置 文件 是 web.xml ， 而 在 Java 中 ， 该 配置 文件 是 
appengine-web .xml。 

(2) 编写 一 个 XMPP 处 理 程序 ， 这 确实 只 是 一 个 实现 POST 的 标准 的 HTTP 请 求 处 理 程序 。 

(3) 注册 XMPP 处 理 程序 。App Engine 总 是 将 XMPP 消 息 映 射 到 一 个 特定 的 URL: /_ah/xmpp/ 
message/chat/， 所 以 ， | 

有 了 上 述 的 设置 ， 人 们 就 可 以 通过 给 anything@your-app-id.appspot.com 发 送 一 条 消息 
来 向 开发 者 的 应 用 程序 发 送 聊天 消息 。 


要 在 Python 中 接收 XMPP 消 息 ， 开 发 者 首先 需要 在 app.yam1 中 加 入 以 下 表 项 : 


inbound_services : 
- xmpp_message 


后 ， 编 写 一 个 XMPP 处 理 程序 : 


class XMPPHandler (webapp.RequestHandler): 
def post(self): 
message = xmpp.Message(self.request.POST) 
message.reply("Received message: %s\nHello to you too" % message.body) 


开发 者 只 需要 获取 POST 请 求 ， 让 XMPP 服 务 将 其 转换 为 一 个 XMPP 消 息 对 象 ， 然 后 得 到 消息 
(message.body )、 发 送 者 ( message.sender ) 或 预期 的 收 件 人 (message.to) 即 可 。 
最 后 ， 开 发 者 需要 注册 该 处 理 程序 : 


application = webapp.WSGIApplication([('/_ah/xmpp/message/chat/', XMPPHandler)]) 









































15.3.4 ”在 Java 中 接收 聊天 消息 


Java 中 的 基本 步骤 与 Python 中 的 几乎 相同 ， 但 是 ， 像 往常 一 样 ， 为 了 匹配 语言 间 的 差异 ， 其 
形式 略 有 不 同 。 首 先 ， 开 发 者 通过 在 应 用 程序 的 配置 文件 appengine-web .xm1 中 添加 一 个 表 项 ， 
告诉 App Engine 开 发 者 要 接收 聊天 消息 。 


<inbound-services> 
<service>xmpp_message</service> 
</inbound-services> 


然后 ， 编 写 一 个 消息 处 理 程序 : 


import java.io.IOException; 

import javax.servlet.http.*; 

import com.google.appengine.api.xmpp.JID; 

import com.google.appengine.api.xmpp.Message; 

import com.google.appengine.api.xmpp.XMPPService; 

import com.google.appengine.api.xmpp.XMPPServiceFactory; 
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public class XMPPReceiverServlet extends HttpServlet { 
public void doPost(HttpServletRequest req, HttpServletResponse res) 
throws IOException { 
XMPPService xmpp = XMPPServiceFactory.getXMPPService(); 
Message message = xmpp.parseMessage(req); 


JID from]id = message.getFromJid(); 
String body = message.getBody() ; 
A ss 


} 
最 后 ， 通 过 在 开发 者 的 web.xm] 文 件 中 加 入 servlet 和 servlet-mapping 表 项 ， 注 册 此 处 理 
程序 ， 如 以 下 配置 所 示 : 


<servlet> 
<servlet-name>xmppreceiver</servlet-name> 
<servlet-class>XMPPReceiverServlet</servlet-class> 
</servlet> 
<servlet-mapping> 
<servlet-name>xmppreceiver</servlet-name> 
<url-pattern>/_ah/xmpp/message/chat/</url-pattern> 
</servlet-mapping> 


15.4 ”发 送 和 接收 电子 邮件 


与 XMPP 的 机 制 类 似 ， 开 发 者 还 可 以 在 App Engine 中 发 送 和 接收 电子 邮件 。 虽然 起 初 这 项 功 
能 看 起 来 有 点 傻 , 但 如 果 仔 细 想 一 下 ,其 实 你 就 会 发 现 , 发 送 邮 件 实际 上 比 发 送 即 时 消息 更 为 普 
遍 ， 更 为 有 用 。 
电子 邮件 常用 于 在 线 注 册 、 通 知 ,并 进行 验证 。 当 用 户 第 一 次 使 用 一 个 提供 聊天 服务 的 网 站 
时 ， 通 常 必须 注册 ， 而 且 用 户 要 通过 电子 邮件 注册 。 如 果 开 发 者 有 一 家 商店 ,通常 会 通过 电子 邮 
件 发 送 收据 和 确认 信息 。 如 果 用 户 需要 重新 设置 密码 ,开发 者 通常 会 通过 电子 邮件 完成 这 项 工作 。 
如 果 用 户 在 有 内 容 更 改 时 想 知 道 相关 情况 , 比如 说 当 他 们 没有 登录 的 时 候 是 否 有 人 在 聊天 室 向 某 
个 讨论 添加 了 内 容 , 或 者 商店 里 缺 货 的 商品 有 货 了 ,用 户 往 往 会 希望 通过 电子 邮件 了 解 这 些 信息 。 
所 以 说 ,发 送 电子 邮件 是 很 常见 的 。 它 既 不 像 持久 性 数据 那样 无 处 不 在 ， 也 不 像 发 送 即 时 消 
息 那 样 不 常见 。App Engine 提 供 了 一 个 非常 简单 灵活 的 服务 ， 让 开发 者 的 应 用 程序 能 够 发 送 和 接 
收 电 子 邮件 。 


15.4.1 发 送 邮件 


发 送 邮 件 再 简单 不 过 了 。 在 Python 中 , 一 旦 开发 者 导入 了 邮件 服务 , 发 送 邮件 就 是 一 行 代 码 。 
要 给 我 从 chat-serviceamarkcc-java-chat.appspot.com 人 发送 主题 为 “Hi Mark!”， 消 息 主题 
为 “Iam still running” 的 邮件 ， 开 发 者 需要 做 的 所 有 工作 就 是 如 下 这 些 : 
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from google.appengine.api import mail 


mail.send_mail("chat-service@markcc-java-chat.appspot.com", 
"markccQ@gmail.com", "Hi Mark!", "I'm still running") 


在 Java 中 更 复杂 一 点 。Java 在 javax.mail 包 中 为 发 送 邮 件 提 供 了 一 个 标准 的 API， 而 App 
Engine 只 是 提供 了 一 个 实现 ,与 上 述 Python 脚 本 中 的 简单 的 一 行 代 码 等 价 的 Java 代 码 是 这 样 的 : 


import java.util.Properties; 


import javax.mail.Message; 

import javax.mail.MessagingException; 

import javax.mail.Session; 

import javax.mail.Transport; 

import javax.mail.internet.AddressException; 
import javax.mail.internet.InternetAddress; 
import javax.mail.internet.MimeMessage; 


Session mailSession = Session.getDefaultInstance(new Properties(), null); 
try { 
Message msg = new MimeMessage(session); 
msg.setFrom(new InternetAddress("chat-service@markcc-java-chat.appspot.com")); 
msg.addRecipient(Message.RecipientType.T0, 
new InternetAddress("markcc@gmail.com")); 
msg.setSubject("Hi Mark!"); 
msg.setText("I'm sti]1] running!"); 
Transport.send(msg); 
} catch (AddressException e) { 
// 邮件 地 址 错误 时 的 处 理 方式 
} catch (MessagingException e) { 
// 发 送 失 败 ( 非 邮件 地 址 出 错 ) 时 的 处 理 方式 





} 


15.4.2 ”接收 邮件 


相对 来 说 ， 接 收 邮件 稍微 复杂 一 些 ， 它 遵循 通用 的 App Engine 通 过 服务 接收 数据 的 模式 。 开 
发 者 通过 在 应 用 程序 的 配置 中 添加 表 项 ,告诉 App Engine 想 要 从 该 服务 接收 数据 。 然 后 App Engine 
会 将 从 该 服务 传 入 的 消息 路 由 到 一 个 虚拟 的 HTTP 的 URL。 在 这 个 网 址 ， 消 息 能 够 被 开发 者 的 消 
息 处 理 程序 或 者 servlet 处 理 。 为 简单 起 见 ， 我 将 给 读者 展示 一 个 Python 应 用 程序 如 何 能 够 接收 
电子 邮件 的 简单 例子 。 像 往常 一 样 ，Java 的 解决 方案 与 Python 几乎 相同 ， 但 有 一 点 更 复杂 。 

该 模式 的 第 一 步 是 告诉 App Engine， 开 发 者 的 应 用 程序 要 使 用 电子 邮件 服务 接收 传人 的 日 
邮件 。 要 实现 此 功能 ， 开 发 者 只 需要 在 其 app.yam] 文 件 添 加 一 个 inbound_services 表 项 : 


inbound_services : 
- mail 


开发 者 设置 好 这 些 内 容 后 ， 其 应 用 程序 就 可 以 接收 电子 邮件 了 。 应 用 程序 会 收 到 发 送 到 
your-app-id.appspotmai1.com 的 所 有 电子 邮件 。 开 发 者 需要 为 传人 的 电子 邮件 设置 一 个 处 理 
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程序 。 电 子 邮 件 会 在 虚拟 网 址 /_ah/mai1/receiver-address 上 接收 。 举 例 来 说 ， 如 果 有 人 给 


admin@markcc-chatro 
/_ah/mail/admin@Qmar 


om-one.appspotmail.com 发 送 电 子 邮 件 ， 我 的 应 用 程序 会 在 网 址 
kcc-chatroom-one.appspotmail1.com 收 到 该 电子 邮件 。 














为 了 处 理 该 电子 邮件 , 开发 者 需要 为 电子 邮件 网 址 设立 一 个 处 理 程序 。 假设 我 想 给 聊天 服务 
添加 电子 邮件 功能 , 使 人 们 可 以 给 管理 地 址 发 送 邮 件 , 并且 要 求 邮件 自动 转发 给 我 ,那么 我 需要 
做 的 是 添加 一 个 脚本 处 理 收 到 的 电子 邮件 。 因 为 邮件 接收 被 伪装 成 HTTP 请 求 ， 如 果 想 要 将 其 实 
现 为 一 个 简单 的 RequestHandler ， 那 么 就 需要 将 传人 的 请 求解 析 为 电子 邮件 的 信息 。 但 App 


Engine 提 供 了 一 个 可 以 











毕 承 的 InboundMai1Handler 类 ， 不 用 手工 完成 解析 。App Engine 提 供 了 


一 个 POST 的 实现 ， 获 取 传人 的 消息 ， 并 将 其 解析 成 一 个 InboundEmai1Message， 然 后 对 该 消息 








调用 receive。 因 此 ， 我 需要 做 的 所 有 工作 就 是 提供 一 个 receive 的 实现 ， 例 如 下 面 的 实现 : 


multichat/chatmail.py 


import email 


from google.appengine.ext import webapp 
from google.appengine.ext.webapp.mail_handlers import InboundMailHandler 
from google.appengine.ext.webapp.util import run_wsgi_app 


class ChatMailHandler(InboundMailHandler): 
def receive(self, mail_message): 
mail.send_mail(sender="admin@markcc-chatroom-one.appspot.com", 


to="markccQgmail.com", 

subject="CHAT ADMIN MAIL: %s" % mail_message.subject, 
body="Original message from: %s\n%s" % 
(mail_message.sender, 

mail_message.body) 


chatmail = webapp.WSGIApplication([InboundMailHandler.mappingO)]) 


def mainO): 


run_wsgi_app(chatmail1) 


if ame__== " m 


ain 





main(C) 














有 了 该 处 理 程序 后 , 我 通过 在 app .yam1 中 添加 表 项 , 告诉 App Engine 它 应 该 将 在 电子 邮件 网 
址 收 到 的 消息 路 由 到 包含 该 处 理 程序 的 脚本 中 


- url: /_ah/mail/.+ 














script: chatmail.py 


InboundEmai1Message 包 含 了 电子 邮件 消息 的 所 有 头 部 和 主体 元 素 的 字段 。 




















口 sender: 邮件 发 件 人 的 电子 邮件 地 址 。 

口 to: To 头 部 中 的 电子 邮件 地 址 。 

口 cc: cc 头 部 中 的 电子 邮件 地 址 。 

口 reply_to: 答复 邮件 应 发 送 到 的 电子 邮件 地 址 ， 由 Rep1y-To: 头 部 声明 。 
口 subject: 邮件 主题 。 


15.5 服务 结束 语 183 





口 body: 邮件 正文 的 内 容 。 
D attachments: 邮件 附件 的 列表 。 这 是 个 二 元 组 的 列表 ， 其 中 第 一 个 元 素 是 附件 的 名 称 ， 
第 二 个 是 附件 的 内 容 。 
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这 一 章 快 速 浏览 了 App Engine 中 服务 的 思想 ,我 们 已 经 看 到 了 一 组 最 常见 的 App Engine 服 务 ， 
包括 提供 对 最 常用 数据 对 象 的 快速 访问 的 服务 ， 实 现 HTTP 请 求 与 其 他 网 络 通 信 的 服务 ， 以 及 一 
些 发 送 和 接收 电子 邮件 和 聊天 消息 的 基本 服务 。 在 这 个 过 程 中 , 我 们 知道 了 服务 看 起 来 应 该 是 什 
么 样子 的 ， 以 及 可 以 如 何 与 服务 进行 交互 。 我 们 看 到 App Engine 如 何 针对 传人 的 数据 实现 处 理 程 
序 , 甚至 当 不 是 真 的 HTTP 时 ,使 用 伪 URL 和 HTTP 门 面 。 并 且 , 我 们 使 用 一 些 服务 提升 了 之 前 构 
建 的 应 用 程序 。 不 但 使 用 Memcache 为 我 们 实现 的 文件 系统 提供 了 缓存 ， 而 且 使 用 电子 邮件 服务 
让 聊天 应 用 程序 可 以 接收 来 自用 户 的 电子 邮件 。 

在 下 一 章 中 ,我 们 将 了 解 如 何 使 用 和 构建 在 App Engine 服 务 器 上 执行 大 量 计算 的 App Engine 
服务 。 这 是 我 们 第 一 次 实现 不 是 完全 响应 式 的 应 用 程序 一 一 响应 式 的 应 用 程序 只 在 用 户 明 确 要 求 
时 执行 操作 一 一 我 们 的 应 用 程序 要 在 服务 器 上 自动 运行 任务 , 而 不 需要 用 户 的 干预 。 在 实现 该 应 
用 程序 的 过 程 中 ， 我 们 将 使 用 更 多 的 App Engine 服 务 : 调度 任务 使 其 在 一 定 的 时 间 发 生 ， 将 任务 15 
放 入 队列 在 App Engine 云 的 某 处 运行 ， 并 将 计算 的 结果 发 送 给 其 他 应 用 程序 。 
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到 目前 为 止 ， 我 们 的 所 有 App Engine 程 序 都 是 完全 被 动 的 ， 由 请 求 来 驱动 。 这 些 应 用 程序 位 
于 App Engine 的 服务 器 上 , 完全 不 做 任何 事情 ,除非 用 户 发 起 某 种 请 求 , 才 立 即 响应 用 户 的 请 求 ， 
然后 返回 ， 继 续 不 做 任何 事情 。 对 于 很 多 应 用 程序 而 言 ， 这 样 的 行为 正 是 我 们 想 要 的 。 一 个 聊天 
室 实际 上 并 不 需要 做 任何 事情 , 除了 用 户 请 求 消 息 时 将 消息 发 给 用 户 。 文件 系统 本 身 不 进行 读 文 
件 或 者 写 文件 ， 只 有 在 有 人 特别 要 求 它 的 时 候 ， 它 才 进 行 操 作 。 

但 是 ， 有 时 这 种 被 动 的 方法 并 不 适用 。 例 如 ， 如 果 开 发 者 正在 构建 一 个 电子 商务 网 站 ， 可 能 

得 到 每 天 销售 的 总 结 , 或 者 ， 如 果 开 发 者 正在 构建 一 个 协作 式 日 历 应 用 程序 ， 可 能 希望 能 够 通 
这 些 工 作 就 不 是 被 动 的 。 它们 需要 服务 器 运行 一 些 不 需要 请 求 来 触发 的 
代码 完成 相应 的 操作 ， 这 些 代码 可 能 基于 时 间或 者 基于 某 些 数据 相关 的 事件 。 

App Engine 为 非 被 动 的 基于 服务 器 的 计算 提供 了 两 种 机 制 , 一 种 是 按照 一 个 固定 的 时 间 表 执 
行 操作 ， 还 有 一 种 是 按照 基于 事件 的 JavaScript 机 制 执行 。 在 这 一 章 中 ， 我 们 将 学 习 这 两 种 机 制 ， 
并 看 看 如 何 利用 这 两 种 机 制 在 服务 器 上 运行 任务 。 

这 是 App Engine 真 正 的 亮点 之 一 。 正 如 我 们 已 经 在 本 书 中 看 到 的 ，App Engine 是 围绕 HTTP 
请 求 处 理 程序 构成 的 。 在 服务 器 计算 里 也 是 一 致 的 ， 开 发 者 还 是 将 其 所 有 的 代码 编写 为 简单 的 
HTTP 请 求 处 理 程序 。 由 于 App Engine 人 允许 开发 者 使 用 这 些 请 求 处 理 程序 ， 所 以 开发 者 可 以 为 其 
需要 在 服务 器 端 计 算 的 任务 构建 任意 复杂 的 工作 流 。 这 是 一 种 非常 优雅 的 实现 方式 , 在 不 增加 大 
量 复杂 性 的 前 提 下 ， 开 发 者 能 够 完成 其 需要 做 的 任何 工作 。 

我 们 将 从 了 解 最 简单 的 服务 器 计算 方式 开始 ， 即 按照 有 规律 的 时 间 表 执行 操作 。 在 此 之 后 ， 
我 们 将 转移 到 更 加 强大 、 灵 活 的 任务 队列 方面 , 在 任务 队列 中 , 通过 处 理 用 户 请 求 可 以 动态 完成 
服务 器 上 的 复杂 计算 序列 。 


16.1 用 App Engine Cron 调度 作业 


作为 云 应 用 程序 的 管理 者 ， 开 发 者 很 有 可 能 想 要 查 明 其 系统 是 如 何 被 使 用 的 。 他 可 以 从 App 
Engine 的 仪表 板 中 得 到 很 多 这 样 的 信息 。 但 是 ,开发 者 常常 会 发 现 还 需要 检查 一 些 应 用 程序 特定 
的 数据 。 

例如 ， 如 果 开 发 者 正在 运行 一 个 网 上 商店 ， 会 想 进行 每 日 总 结 , 汇总 客户 的 购买 量 以 及 
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在 这 些 交 易 中 所 获得 的 利润 。App Engine 的 仪表 板 不 能 提供 这 样 的 信息 。 它 可 以 告诉 开发 者 有 多 
少 访问 者 来 过 其 商店 ， 在 商店 果 了 多 久 , 使 用 了 多 少 CPU 资 源 , 修改 了 多 少 个 数据 仓库 对 象 ,与 
其 交互 耗费 了 多 少 带宽 ， 但 它 并 不 能 显示 出 消耗 了 多 少 库存 或 者 赚 了 多 少 钱 。 

开发 者 可 以 通过 一 个 URIL 查 看 这 些 细节 , 可 以 向 对 应 的 URL 发 送 请 求 , 查看 在 某 一 天 中 的 收 
益 。 但 如 果 想 在 经 营 中 每 天 都 看 到 该 报告 可 怎么 办 呢 ? 如 果 不 用 记 住 网 址 、 请 求 报告 、 然 后 保存 
这 一 系列 操作 ， 而 让 App Engine 每 天 自动 生成 报告 并 发 送 给 我 们 ,该 有 多 好 啊 ! 

实际 上 , 我 们 并 没有 实现 网 上 商店 这 样 的 应 用 , 这 个 例子 对 于 本 书 来 讲 有 点 太 复 杂 。 然而 ， 
调度 任务 的 过 程 ， 如 报表 生成 ,对 于 网 上 商店 与 聊天 服务 来 说 并 没有 很 大 的 不 同 。 事实 上 ,这 
是 一 个 很 常见 的 需要 : 调度 任务 的 关键 就 是 查看 开发 者 的 应 用 程序 在 一 定 的 时 间 段 内 产生 的 所 
有 数据 ， 并 分 析 数 据 。 分 析 的 目的 不 同 ， 对 于 网 店 ， 目 标 可 能 是 要 为 店主 生成 报告 ;而 对 于 聊 
天 系统 ， 可 能 就 会 用 于 决定 是 否 应 该 终止 一 个 数 天 没有 任何 活动 的 聊天 室 。 但 两 者 基本 目标 是 
相同 的 ， 都 是 要 设立 一 个 时 间 表 ， 在 这 个 时 间 表 所 指定 的 时 间 分 析 数 据 ， 并 采用 分 析 的 结果 做 
一 些 有 用 的 工作 。 

接 下 来 ， 我们 将 使 用 报表 生成 作为 一 个 典型 的 例子 ， 并 为 聊天 服务 设置 一 个 报表 生成 功能 ， 
生成 一 个 每 天 每 个 聊天 室 发 送 了 多 少 个 消息 的 报告 。 



























































16.1.1 ” Cron 调度 器 


我 们 的 应 用 程序 有 一 个 时 间 表 文件 。 在 Java 中 ， 该 文件 被 命名 为 WEB-INF/cron.xm1; 在 
Python 中， 是 cron.yam1。 由 于 我 们 使 用 的 是 聊天 应 用 程序 的 Java 版 本 ， 所 以 将 在 
WEB-INF/cron.xml1 文 件 中 增加 一 个 条 目 。 该 文件 包含 了 封装 在 <cronentries> 标 签 中 的 条 目 列表 。 
每 个 条 目 是 一 个 <cron> 元 素 。 
cron 条 目 包 含 了 三 个 字段 ， 表 示 为 XML 子 元 素 。 
口 <url> 
首先 ， 它 有 一 个 URL。 正 如 我 们 在 App Engine 中 反复 看 到 的 ， 基 本 上 一 切 内 容 都 封装 在 
HTTP 的 请 求 中 一 一 几乎 所 有 内 容 都 使 用 HTTP 请 求 处 理 程序 实现 。Cron 也 不 例外 。App 
Engine 会 根据 时 间 表 为 该 URL 生 成 一 个 GET 请 求 。 
口 <description> 
其 次 ， 有 一 个 描述 。 这 仅仅 是 文档 性 描述 ， 并 没有 执行 时 间 的 效果 。 描 述 用 来 让 人 们 阅 
读 cron 文 件 ， 以 了 解 任务 是 什么 。 

口 <schedule> 
关于 任务 应 该 何 时 被 调用 的 文字 描述 。 

时 间 表 的 编写 看 起 来 像 一 个 英文 说 明 。 

口 every+ 数 字 + 单 位 
在 指定 的 时 间 间 隔 运 行 。 例 如 ，every 2 hours (每 2 小 时 )， 或 every 3 minutes ( 每 3 
分 钟 )。 

口 every 时 间 
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在 指定 的 时 间 运 行 。 例 如 ,every monday 12:00 是 在 每 星期 一 中 午 运行 ,every day 00:00 

是 在 每 天 的 午夜 运行 。 

DO nth 时 间 of 月 份 
如 果 开 发 者 想 要 得 到 的 报告 不 频繁 ， 则 可 以 以 月 为 单位 来 指定 时 间 : 2nd tuesday (省 
略 月 表示 每 个 月 )， 或 者 3rd Friday of march ,june,september,december， 即 一 年 运 
行 4 次 报告 。 

例如 ， 要 使 聊天 室 每 天 生成 一 个 报告 ， 在 cron 文 件 中 加 入 如 下 内 容 : 


























ws2/ReportingChat/war/WEB-INF/cron.xml 


<?xm] version="1.0" encoding="UTF-8"?> 
<Cronentries> 
<cron> 
<url>/report?to=markccQgmail.com</url1l> 
<description>Generate a daily chat usage report.</description> 
<schedule>every day 00:00</schedule> 
</cron> 
</cronentries> 


该 报告 将 通过 向 /report URL 发 送 GET 而 生成 ， 并 在 每 天 的 午夜 完成 。 
16.1.2 ”实现 Cron 请 求 处 理 程序 


请 求 处 理 程序 的 基本 代码 很 简单 。 我 们 已 经 学 过 如 何 编写 聊天 消息 的 数据 仓库 查询 一 一 这 个 
程序 中 只 要 能 够 进行 查询 ,并 返回 过 去 24 小 时 内 添加 的 所 有 聊天 消息 即 可 。 然后, 我 们 检查 消息 
的 长 度 ， 就 能 得 到 想 要 的 结果 。 

严格 地 说 ,这 种 实现 是 矫 枉 过 正 ， 其 实 不 需要 取 回 所 有 消息 。 但 是 , 在 大 多 数 分 析 或 者 报告 
的 预定 任务 中 , 我 们 希望 能 够 排查 最 近 一 段 时 间 中 的 所 有 数据 ， 所 以 这 是 开发 者 在 这 类 任务 中 会 
使 用 的 基本 结构 : 取 回 所 有 内 容 ， 然 后 对 其 排除 ， 最 后 生成 结果 。 
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ws2/ReportingChat/src/com/pragprog/aebook/chat/server/Reporter.java 


@SuppressWarnings ("serial") 
public class Reporter extends HttpServlet { 


Logger logger = Logger.getLogger(CReporter .class.getName()); 


GOverride 
Q@SuppressWarnings("unchecked"”) 
protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
throws ServletException, IOException { 
String toAddress = req.getParameter("to"); 

0 PersistenceManager persister = Persister.getPersistenceManager() ; 
Query query = persister.newQuery(CPChatMessage.class) ; 
query.setFilter("date >= yesterday"); 
query.declareParameters("1ong yesterday"); 
query.setOrdering("date"); 
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long yesterday = System.currentTimeMillis() - (24 * 60 * 60 * 1000); 
List<PChatMessage> messages = 

(List<PChatMessage>)query.execute(yesterday) ; 
resp.setContentType("text/htmi"); 


© PrintWriter out = new PrintWriter(new CharArrayWriter()); 
out.printin("<htm]>"); 
out.printin(" <head>"); 
out.println(” <title>Chat Usage Report</title>"); 
out.println(” </head>"); 
out.printin(" <body>"); 
out.println(” <hI>Chat Usage Report</h1>"); 
out.println(” <p> Messages in the last 24 hours: " + 
messages.size()); 
out.printin("</body></htm]1>"); 
out.close(); 
String report = out.toString() ; 


Session mailSession = 
© Session.getDefaultInstance(new Properties(), null); 
try { 
Message msg = new MimeMessage(mailSession); 
msg.setFrom(new InternetAddress(toAddress)); 
msg.addRecipient(Message.RecipientType.T0, 
new InternetAddress(req.getParameter("to"))); 
msg.setSubject("Chat Status Report"); 
msg.setText(report); 
Transport.send(msg); 
} catch (AddressException e) { 
// 邮件 地 址 是 一 有 效 的 常量 ， 因 此 这 种 情况 不 可 能 发 生 
} catch (MessagingException e) { 
logger.1log(Level.INFO, "Error sending report: 





+ e); 


} 


+ 
此 代码 就 是 一 个 简单 的 servlet 一 一 现在 ， 开 发 者 应 该 不 用 任何 帮助 就 能 够 读 懂 这 些 代码 了 。 这 只 
是 我 们 以 前 见 过 的 代码 的 组 合 而 已 : 
@@ 首先 ， 我 们 采用 通常 的 持久 性 方式 组 成 查询 语句 ， 并 从 数据 仓库 中 取 回 聊天 消息 ， 就 像 
10.1 节 中 的 代码 一 样 。 
@ 然后 我 们 利用 这 些 信息 生成 一 个 包含 报告 的 字符 串 。 
@ 最 后 ， 使 用 在 15.4 节 中 看 到 的 App Engine 的 邮件 服务 ， 发 送 该 消息 。 
0 情 需要 处 理 。 我 们 告诉 调度 器 在 /reportURL 为 应 用 程序 生成 一 个 请 求 ， 因 而 ， 
告诉 App Engine 将 该 servlet 连 接 到 此 网 址 。 我 们 按照 往常 的 方法 实现 该 工作 ， 即 通过 在 
oo .xm] 的 <servlet> 元 素 中 添加 一 个 条 目 ， 注 册 该 servlet ， 然 后 添加 一 个 
<servlet-mapping> 条 目 ， 将 该 servlet 和 该 URL 绑 定 。 


























<servlet> 
<servlet-name>ChatServletReporter</servlet-name> 
<servlet-class>com.pragprog.aebook.chat.server.Reporter</servlet-class> 
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<auth-constraint> 
<role-name>admin</role-name> 
</auth-constraint> 
</servlet> 


<servlet-mapping> 
<servlet-name>ChatServletReporter</servlet-name> 
<url-pattern>/report</url-pattern> 
</servlet-mapping> 


16.2 用 任务 队列 动态 运行 作业 


第 二 种 在 服务 器 上 执行 计算 的 方法 比 cron 调 度 更 灵活 ， 更 有 趣 。 然 而 ， 基 本 元 素 则 采用 类 似 
的 方式 处 理 : 开发 者 在 用 户 请 求 之 外 想 要 做 的 每 项 工作 都 要 设置 为 在 特定 虚拟 URL 上 的 HTTP 请 
求 处 理 程序 。 

在 使 用 cron 调 度 器 时 ， 我们 指定 应 该 根据 一 个 具体 的 时 间 表 来 调用 特定 请 求 ,但 也 有 很 多 任 
务 没有 必要 在 时 间 表 里 调度 。 例如 ,在 博客 上 , 会 定期 检查 它 有 多 少 次 点 击 以 及 这 些 点 击 来 自 哪 
里 ; 如 果 在 数据 中 得 到 了 任何 有 趣 内 容 , 我 就 会 向 邮箱 发 送 一 个 报告 的 副本 。 这 种 操作 没有 一 个 
具体 的 时 间 表 一 一 当 看 到 某 些 想 要 参考 的 内 容 时 ， 就 要 求 发 送 一 个 报告 。 

App Engine 提 供 的 一 种 服务 可 以 处 理 类 似 这 样 的 事情 ， 它 被 称 为 任务 队列 (task queue )。 任 
务 队列 是 一 种 非常 通用 的 机 制 , 可 用 来 做 任何 最 终 由 用 户 请 求 所 发 起 的 工作 一 一 它 并 不 一 定 是 需 
要 立即 完成 的 工作 。 例如 ， 如 果 想 建立 一 个 在 线 日 历 ， 则 可 以 让 日 历 应 用 程序 向 任务 队列 添加 一 
些 内 容 以 发 送 电 子 邮件 提醒 ; 任务 将 被 放 到 一 个 队列 中 ,队列 会 指示 其 应 该 何 时 运行 。 当 用 户 创 
建 日 历 条 目 时 , 该 任务 就 进入 了 队列 ,实际 的 任务 直到 满足 激活 条 件 时 才 执 行 。 任 务 队列 是 个 非 
常 强大 的 机 制 ， 那 些 从 任务 队列 中 运行 的 任务 ， 它 们 自己 可 以 向 队列 中 添加 其 他 的 任务 ! 由 此 ， 
任务 队列 就 成 为 一 种 能 够 构建 任意 任务 序列 和 流程 的 完全 通用 的 工作 流 系统 。 

任务 队列 的 基本 思路 很 简单 。 应 用 程序 可 以 指定 一 组 命名 工作 池 , 工作 池 包 含 需要 完成 的 工 
作 , 称 为 任务 队列 。 每 个 工作 单元 由 一 个 请 求 进 行 描述 。App Engine 服 务 器 会 定期 检查 任务 队列 ， 
如 果 有 任何 请 求 在 队列 中 等 待 ， 服 务 器 就 会 触发 它们 ， 并 执行 处 理 程序 。 在 一 般 情 况 下 ， 当 开发 
者 把 某 任务 放 到 任务 队列 后 ，App Engine 会 尽快 地 运行 它 ， 但 并 不 保证 要 等 多 长 时 间 。 



















































































16.2.1 任务 


那么 ,什么 是 任务 呢 ? 从 概念 上 讲 , 任务 是 一 个 小 的 工作 单元 。 它 基本 上 是 语言 中 的 一 个 函 
数 ， 例 如 在 Python 中 用 于 接收 参数 与 输入 并 随后 执行 计算 的 一 大 段 代 码 。 从 App Engine 程 序 调 用 
一 个 任务 和 调用 一 个 函数 /方法 的 主要 区 别 在 于 ， 任 务 是 异步 的 ， 它 与 构建 Java 用 户 界 面 所 用 的 
GWT 方 法 一 样 ， 调 用 者 本 质 上 只 需 说 明 “ 我 要 完成 这 个 任务 ”， 然 后 就 可 以 去 做 其 他 事情 了 。 调 
用 者 不 会 等 竺 结果。 如 果 调 用 者 需要 使 用 结果 做 某 些 事情 , 那么 它 必 须 提供 一 个 回调 函数 。 在 常 
规 编程 语言 如 Java 中 ， 使 用 对 象 描 述 了 回调 函数 。 在 任务 环境 中 ， 回 调 不 是 一 个 对 象 ， 而 是 另 一 
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项 任务 。 如 果 这 听 起 来 有 点 混乱 ， 不 必 担 心 ， 让 我 们 来 看 一 些 具体 的 例子 。 

假如 正在 构建 一 个 协作 式 日 历 应 用 程序 。 任 何 用 户 都 可 以 安排 会 议 , 向 其 他 人 发 送 邀 请 ,这 
些 人 可 以 回应 、 接 受 或 拒绝 邀请 。 当 会 议 发 生 时 ， 该 应 用 程序 向 预计 与 会 者 发 送 提醒 。 

我 们 在 日 历 上 创建 一 个 会 议 时 , 可 能 希望 向 人 们 发 送 电子 邮 件 邀 请 函 , 这 可 以 通过 为 每 个 邀 
请 函 创 建 一 个 任务 来 实现 。 我 们 不 想 在 用 户 等 待 请 求 响应 时 发 送 邀 请 函 ， 因为 发 送 邮 件 的 速度 很 
慢 ! 如 果 有 十 儿 个 被 邀请 者 ， 发送 十 儿 封 邮件 会 使 用 户 挂 起 很 长 一 段 时 间 。 所 以 只 需 创建 一 堆 的 
任务 并 将 其 放 入 队列 即 可 。 这 些 发 送 任 务 会 被 完成 ， 但 不 需要 等 待 它们 完成 。 

这 就 是 基本 思路 。 开 发 者 的 App Engine 代 码 总 是 编写 为 一 堆 HTTP 请 求 处 理 程序 ,或 者 servlet。 
如 果 开 发 者 想 在 服务 器 上 进行 计算 , 那么 就 创建 某 个 任务 ,告诉 服务 器 如 何 产生 请 求 ， 这 样 就 完 
成 了 工作 。 编 写 的 任务 实现 方式 并 没有 什么 特别 之 处 ,任务 只 是 事件 处 理 程序 。 事 实 上 ， 可 以 创 
建 发 送 给 相同 URL 的 请 求 事件 。 任 务 的 实现 和 任何 其 他 处 理 程序 的 实现 实际 上 并 没有 差异 。 我们 
为 cron 任 务 编写 的 报告 处 理 程序 作为 任务 实现 ， 也 可 以 工作 得 很 好 。 也 可 以 编写 提交 聊天 消息 的 
任务 ,只 需 通 过 在 队列 中 加 入 一 个 任务 ,然后 在 提交 聊天 的 URL 上 使 用 正确 的 参数 执行 请 求 即 可 ， 
执行 方式 与 用 户 期 望 的 完全 相同 。 





































































































16.2.2 ”创建 任务 


任务 如 何在 代码 中 呈现 ? 如 前 所 述 ， 它 们 就 是 告诉 服务 器 如 何 创建 HTTP 请 求 的 简单 对 象 。 
因此 , 如 果 想 要 发 送 电 子 邮件 ( 正如 上 一 节 中 ,要 发 送 一 个 聊天 室 使 用 情况 的 日 常 报告 一 样 )， 
就 要 定义 一 个 有 一 个 参数 的 任务 , 这 个 参数 就 是 该 报告 应 该 被 发 送 到 的 电子 邮件 地 址 。 就 这 么 简 
单 。 由 于 报表 生成 的 URL 是 /report， 这 就 是 该 请 求 的 URL。 我 们 实现 了 报告 的 生成 器 ， 以 处 理 
GET 请 求 : 所 以 当 构 建 任 务 时 ， 要 将 其 编写 为 一 个 GET。 并 不 需要 实现 处 理 程序 ， 因 为 已 经 做 好 
了 。Cron 的 工作 中 生成 了 一 个 完全 正常 的 GET， 因 此 ， 任 务 可 以 使 用 相同 的 处 理 程序 一 一 它 只 需 
要 生成 相同 的 、 基 本 的 GET 即 可 。 
如 果 和 希望 用 户 能 够 在 聊天 服务 中 请 求生 成 使 用 报告 ， 那 么 可 以 在 用 户 界 面 中 添加 一 个 按钮 ， 
生成 一 个 GWT 远 程 过程 调 用 。 该 调用 调用 了 generateReport 方 法 : 
@Override 
public void generateReport(String address) { 


TaskOptions task = method(Method.GET) .param("to", address); 
QueueFactory.getDefaultQueue() .add(task); 














@ 


站 

@@ 此 代码 有 一 些 奇怪 的 地 方 。 在 App Engine 中 , 我 们 通过 创建 描述 任务 的 Task0ptions 对 象 
来 提交 任务 。 但 是 ， 我 们 并 没有 显 式 地 创建 该 对 象 。 相 反 ， 我 们 调用 了 类 com.goog1e. 
appengine.api.labs.taskqueue.TaskOptions.Bui1der 中 的 静态 方法 。 为 创建 一 个 
GET 任 务 ， 我们 调用 了 包 com.google.appengine.api.1abs.taskqueue.TaskOptions. 
Builder 中 名 为 method 的 方法 。 但 这 种 实现 方法 需要 输入 很 多 字符 。 在 一 般 情 况 下 ， 在 
任务 队列 的 代码 中 ， 我 们 只 需 做 一 个 静态 导入 ， 将 
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import static com.google.appengine.api.labs.taskqueue.TaskOptions.Builder.*; 

放 在 我 们 的 代码 导入 部 分 , 该 静态 方法 就 变 得 可 用 了 。 只 需要 使 用 methodCMethod .GET) 
就 可 以 创建 一 个 GET 任 务 。 该 方法 将 创建 Task0ptions 对 象 ,然后 再 使 用 选项 对 象 的 方法 
设置 它 的 参数 。 

@ 提交 任务 执行 也 很 简单 ， 只 需 使 用 QueueFactory 的 方法 获取 队列 一 getDefau1tQueue() 
用 于 获取 缺 省 队列 , 或 者 getQueue Cname) 用 于 获取 其 他 任务 队列 。 然 后 ,向 任务 队列 添 
加 任务 选项 对 象 。 

我 们 可 以 配置 以 下 任务 选项 。 

口 任务 的 名 称 
当 我 们 为 任务 队列 创建 一 个 任务 时 ， 可 以 给 它 分 配 一 个 名 称 。 该 名 称 将 出 现在 应 用 程序 
的 Google App Engine 控 制 面板 的 错误 、 日 志和 任务 监视 器 中 。 

口 请 求 的 类 型 
HTTP 请 求 像 往常 一 样 ， 可 以 是 GET、PUT 或 POST 请 求 。 我 们 使 用 method() 方 法 设置 HTTP 
请 求 的 类 型 。 

口 请 求 的 URL 
我 们 不 用 直接 声明 任务 应 该 运行 的 代码 ,只 需 声明 URL。App Engine 发 送 相应 的 请 求 到 该 
URL， 调 用 为 该 URL 设 置 的 请 求 处 理 程序 。 我 们 使 用 ur1Q 方 法 设置 请 求 的 URL。 

口 CGI 参数 
CGI 参数 是 会 被 编码 到 请 求 的 URL 中 的 参数 。 在 一 般 情况 下 ， 使 用 简化 的 CGI 参数 ， 不 包 
括 标点 和 空格 的 简单 值 。 在 我 们 的 例子 中 , 事件 标识 符 使 用 CGI 参 数 , 事件 标识 符 应 该 是 
简单 的 值 , 如 整数 。 如 果 需 要 , 也 可 以 声明 许多 CGI 参数 , 对 于 每 个 CGI 参数 , 调用 param() 
方法 将 其 添加 到 任务 中 。 

口 头 部 参数 
这 些 是 在 HTTP 请 求 的 头 部 行 中 声明 的 参数 。 头 部 参数 是 单行 字符 串 参 数 ， 可 以 有 空格 、 
标点 符号 ， 以 及 其 他 任何 我 们 想 要 的 内 容 。 和 CGI 参数 一 样 ， 如 果 需 要 ， 也 可 以 声明 很 多 
头 部 。 通 过 调用 header 0) 方法 将 头 部 参数 添加 到 任务 中 。 

口 消息 体 
因为 我 们 正在 处 理 HTTP 请 求 ， 所 以 ， 如 果 请 求 是 PUT 或 者 POST， 就 会 有 一 个 消息 体 ， 从 
而 ， 可 以 在 消息 体 中 放 入 我 们 想 要 放 的 任何 内 容 。 可 以 使 用 pay1oad(0) 方 法 设置 消息 体 。 

口 估计 的 执行 时 间 
通过 设置 任务 的 eta (预计 抵达 时 间 )， 可 以 告诉 App Engine， 在 一 个 特定 的 时 间 之 前 ， 
我 们 不 想 执 行 该 任务 。App Engine 的 服务 器 会 将 该 任务 保留 在 队列 中 等 待 ， 直 到 eta 到 了 
之 后 。eta 之 后 ， 服 务 器 会 尽快 执行 该 任务 。 

从 处 理 程 序 方面 来 看 ,任务 更 容易 一 一 本 节 中 反复 说 过 , 它们 只 是 标准 的 事件 处 理 程序 。 但 

有 时 开发 者 可 能 需要 判断 一 个 给 定 的 请 求 是 由 人 还 是 App Engine 事 件 产 生 的 。 例 如 ， 如 果 聊 天 应 
用 程序 中 有 一 个 反馈 框 ， 当 用 户 提交 反馈 时 , 应 用 程序 将 使 用 与 上 边 展示 的 相同 处 理 程序 来 处 理 
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反馈 。 当 有 人 按 提交 按钮 时 ， 他 会 期 望 某 种 反馈 ， 比 如 一 个 消息 , 说 “你 的 反馈 已 经 邮寄 给 系统 
管理 员 ”。 但 是 ， 如 果 该 事件 是 作为 一 个 服务 器 计算 任务 被 调用 的 ， 应 答 中 所 包含 的 任何 内 容 都 
会 被 丢弃 ， 那 么 何必 要 麻烦 地 为 服务 器 生成 应 答 呢 ? 
开发 者 可 以 通过 查看 消息 头 部 来 判断 任务 是 何 时 生成 请 求 的 。 每 一 个 任务 队列 生成 的 请 求 有 

3 个 头 部 ， 描 述 了 调用 它 的 任务 。 
口 X-App Engine-QueueName 创建 任务 的 队列 的 名 字 。 下 一 节 中 将 看 到 ， 我 们 可 以 有 多 个 
任务 队列 ， 每 个 队列 都 有 其 自身 的 配置 。 
口 X-App Engine-TaskName 用 来 标识 该 任务 的 名 称 。 
口 X-Appengine-TaskRetryCount 当 任务 队列 调用 一 个 任务 时 ， 会 等 待 10 分 钟 完成 任务 。 

如 果 在 这 个 时 间 内 没有 完成 ， 或 者 ， 如 果 请 求 返 回 一 个 错误 码 ， 系 统 将 重 试 。 这 个 字段 
通常 为 0, 但 是 ， 如 果 任 务 之 前 失败 了 ， 而 当前 执行 的 是 一 个 重 试 ， 这 个 字段 则 表明 任务 
失败 了 多 少 次 。( 超时 时 间 在 写本 书 的 过 程 中 有 着 相当 显著 的 变化 ， 从 30 秒 到 当前 的 10 分 
钟 不 等 ， 因 此 ， 如 果 超 时 时 间 对 你 真 的 很 重要 ， 你 应 该 检查 目前 Google App Engine 的 任 
务 队列 文档 ， 核 对 当前 的 超时 时 间 是 多 少 , ) 


16.2.3 ”使 用 多 任务 队列 


正如 上 节 所 述 , 可 以 有 多 个 任务 队列 。 不过， 既然 单个 队列 就 可 以 处 理 任意 多 个 任务 , 而 且 
每 个 任务 也 可 以 声明 自己 的 目标 URL 和 参数 ， 所 以 读者 可 能 会 疑惑 为 什么 需要 多 个 队列 。 

多 数 时 候 可 能 并 不 需要 多 任务 队列 。 对 于 许多 应 用 而 言 , 使 用 单一 任务 队列 就 是 以 完成 所 有 
的 服务 器 计算 。 但 也 有 一 些 工 作 是 只 能 以 队列 方式 配置 , 而 不 是 以 单个 任务 方式 实现 的 。 请 记 住 ， 
开发 者 必须 要 为 执行 任务 付费 。 如 果 开 发 者 有 一 个 相对 昂贵 任务 〈 例 如， 发 送 电 子 邮 件 )， 可 能 
希望 限制 队列 执行 的 任务 数 。 可 以 配置 一 个 队列 , 例如 使 其 每 秒 只 处 理 一 个 事件 。 由 此 , 通过 限 
制 其 系统 可 能 发 送 的 邮件 数量 ， 最 终 就 能 控制 为 邮件 服务 所 支付 的 费用 。 

可 能 需要 使 用 多 个 队列 的 男 一 种 情况 就 是 处 理 并 发 。 在 一 般 情况 下 ，App Engine 从 队列 中 按 
顺序 运行 任务 , 也 就 是 说 , 插入 到 队列 的 第 一 项 任务 是 第 一 个 被 执行 的 任务 。 如 果 队 列 中 有 一 百 
个 事件 , 然后 再 添加 另 一 个 任务 , 那么 , 这 个 任务 在 它 之 前 的 一 百 个 任务 执行 完 之 前 不 会 被 执行 。 
如 果 有 一 个 高 优先 级 的 任务 需要 马上 执行 , 就 完全 无 法 用 一 个 队列 完成 , 相反 , 需要 一 个 独立 的 、 
高 优先 级 的 队列 。 普 通 的 任务 发 送 到 默认 的 队列 ,而 发 送 到 较 高 优先 级 队列 的 任务 不 等 默认 队列 
中 的 任务 执行 完 就 可 以 先 执行 。 

每 个 App Engine 应 用 程序 都 有 一 个 默认 的 队列 。 如 果 只 是 想 使 用 默认 的 队列 ， 那么 不 需要 做 
什么 特别 的 工作 。 但 是 如 果 想 要 使 用 多 个 队列 , 那么 通过 给 应 用 程序 添加 一 个 queue .xm] 文 件 就 
可 以 创建 其 他 队列 。 例 如 ， 可 以 使 用 queue.xm1 生 成 一 个 默认 队列 和 一 个 高 优先 级 队列 : 
























































































































































wS2/ReportingChat/warWEB-INF/queue.xml 


<queue-entries> 
<queue> 
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<name>default</name> 
<rate>5/s</rate> 

</queue> 

<queue> 
<name>priority-queue</name> 
<rate>10/s</rate> 

</queue> 

</queue-entries> 


每 个 队列 具有 以 下 可 以 定义 的 特性 。 





口 名 称 
任务 队列 的 名 称 。 
口 速率 





该 队列 处 理 任 务 的 最 大 速率 。 使 用 每 秒 多 少 个 进行 声明 ( 10/s 表 示 每 秒 10 个 ，5/m 表 示 每 


分 钟 5 个 ，1000/d 表 示 每 天 1000 个 )。 


口 总 存储 限制 


在 队列 中 等 待 的 任务 可 使 用 的 总 存储 空间 。 例 如 ，10m 表 示 10 兆 字 节 。 这 不 是 任务 的 处 理 
程序 可 以 使 用 的 空间 , 那 是 由 App Engine 的 设置 决定 的 。 作 为 任务 描述 的 一 部 分 , 该 设置 
仅仅 是 指 可 以 放 在 队列 中 的 信息 数量 。 








16.3 ”服务 器 计算 结束 语 


在 这 一 章 中 , 我 们 讨论 了 在 用 户 请 求 之 外 , 如 何在 App Engine 的 服务 器 上 运行 任务 。 事实 上 ， 
它 很 简单 ， 开 发 者 只 需要 提供 一 组 HTTP 请 求 处 理 程序 ， 或 者 servlet， 就 像 为 其 他 HTTP 请 求 所 提 





供 





的 处 理 程序 一 样 ,然后 ,开发 者 可 以 简单 地 在 任务 队列 中 加 入 一 个 条 


请 求 ， 并 运行 新 的 任务 。 
我 们 没有 讨论 的 一 件 事情 是 如 何 管理 谁 可 以 在 哪个 URL 上 发 送 请 求 。 使 用 任务 队列 , 开发 者 
已 经 获得 了 所 需 的 URL, 提供 给 服务 器 计算 任务 一 个 切入 点 。 开 发 者 不 希望 用 户 能 够 向 这 些 URL 
发 送 请 求 , 无 论 是 说 会 提供 给 人 们 一 个 机 制 使 其 能 够 访问 他 们 实际 不 应 该 访问 的 数据 , 还 是 说 会 
引发 拒绝 服务 式 攻 击 ， 这 都 是 一 个 重大 的 安全 漏洞 。 这 个 问题 在 App Engine 中 尤其 严重 ， 因 为 开 
发 者 要 为 其 所 使 用 的 资源 付费 。 如 果 有 人 能 够 使 用 未 经 授权 的 访问 进行 攻击 , 使 开发 者 的 应 用 程 


序 使 用 了 大 量 的 CPU 时 间 ， 那 么 ， 开 发 者 会 面 对 一 个 非常 
下 一 章 将 详细 地 看 看 安全 问题 。 我 们 将 了 解 安全 的 真正 含义 是 什么 ， 

















Engine 构 建 一 个 安全 的 系统 。 
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本 章 来 学 习 安 全 性 , 这 是 一 些 我 们 还 没有 真正 涉及 过 的 内 容 。 安 全 性 是 一 个 很 大 的 话题 , 要 
完全 徐 盖 这 个 话题 ， 其 篇 幅 会 超出 整 本 书 。 但 是 , 我 们 可 以 快速 了 解 一 下 相关 的 基础 知识 : 安全 
性 的 含义 是 什么 ， 在 App Engine 内 如 何 实现 基本 的 安全 设施 。 


17.1 什么 是 安全 性 


安全 性 的 基本 概念 很 简单 ， 因 为 每 一 个 应 用 程序 都 使 用 某 一 组 数据 对 象 进行 工作 , 安全 性 作 
为 一 种 策略 ,建立 了 一 套 规则 ,定义 了 谁 可 以 查看 或 修改 这 些 数 据 对 象 ， 以 及 以 何 种 方式 查看 或 
修改 这 些 数据 对 象 。 在 一 个 安全 的 系统 中 , 任何 数据 对 象 都 不 能 被 未 经 安全 策略 专门 授权 的 用 户 
查看 或 修改 。 

例如 , 在 聊天 室 应 用 程序 中 ,允许 任何 人 访问 他 们 想 要 访问 的 任意 聊天 室 , 但 只 能 在 登录 之 
后 才能 访问 。 所 以 我 们 已 经 有 了 一 个 非常 薄弱 的 安全 策略 。 聊天 室 中 有 三 种 操作 : 查看 聊天 列表 、 
阅读 聊天 信息 ， 以 及 发 布 聊天 消息 。 只 要 登录 进去 ， 任 何 用 户 都 能 执行 这 些 操作 。 

对 于 许多 应 用 程序 而 言 ， 这 种 安全 性 策略 还 远 远 不 够 。 例如， 想象 一 个 购物 应 用 程序 。 用 户 
应 该 只 允许 查看 和 编辑 他 们 自己 的 购物 车 。 任 何人 都 应 该 能 够 查看 目录 , 但 是 , 应 该 只 有 店内 员 
工 能 够 编辑 目录 。 大 多 数 员工 应 该 能 查看 购物 车 ， 以 帮助 购物 者 ,但 他 们 不 应 该 能 够 改变 购物 车 
的 内 容 。 此 外 ， 应 该 只 有 老板 或 经 理 能 查看 整体 业务 的 财务 状况 。 

但 正如 读者 从 这 个 购物 应 用 程序 的 例子 中 所 看 到 的 , 我 们 仍然 可 以 从 对 象 管理 的 数据 集合 以 
及 对 数据 进行 的 操作 这 两 项 角度 来 施加 必要 的 安全 策略 。 


17.2 基本 的 安全 性 


在 最 基本 的 层面 ， 安 全 性 由 两 部 分 组 成 ,一 部 分 是 定义 安全 策略 ， 另 一 部 分 是 使 用 登录 认证 
和 检查 去 强制 执行 这 一 策略 。 安 全 策略 定义 了 究竟 允许 谁 做 什么 ,通过 登录 认证 来 识别 用 户 , 授 
矛 用 户 应 享有 的 访问 权 ， 检 查 则 可 以 拒绝 用 户 访问 无 权限 内 容 。 

本 节 将 通过 一 个 例子 来 介绍 如 何 定义 基本 安全 策略 ， 以 及 如 何 使 用 App Engine 的 设施 实现 这 
一 策略 。 我 们 将 给 聊天 应 用 程序 添加 一 个 管理 设施 , 并 定义 安全 策略 ， 对 使 用 该 应 用 程序 的 用 户 
加 以 控制 。 

































































194 第 17 章 App Engine 服 务 的 安全 性 





17.2.1 添加 聊天 室 的 管理 功能 


下 面 还 是 通过 聊天 应 用 程序 来 简单 地 介绍 基本 安全 性 。 在 我 们 原来 的 聊天 应 用 程序 中 , 可 用 
的 聊天 室 集合 是 固定 的 。 当 应 用 程序 首次 运行 时 , 会 自动 初始 化 一 个 聊天 室 的 小 列表 , 这 是 所 有 
被 允许 使 用 的 聊天 室 。 为 了 改变 该 列表 ， 我 们 需要 修改 聊天 应 用 程序 的 源 代码 。 

与 以 前 不 同 的 是 , 我 们 希望 能 够 动态 创建 新 聊天 室 , 但 不 希望 任何 用 户 都 能 够 随意 乱 精 精 地 
创建 聊天 室 ， 要 对 用 户 的 权限 加 以 控制 。 

先 来 定义 一 个 安全 策略 , 描述 一 下 应 用 程序 所 要 用 的 基本 资源 及 操作 的 集合 。 然 后 再 来 学 习 
一 下 如 何在 App Engine 中 实现 这 些 策略 。 

安全 策略 有 三 种 对 象 : 聊天 室 、 聊 天 消息 和 用 户 。 只 围绕 其 中 的 两 个 来 定义 安全 策略 : 用 户 和 
聊天 室 。 单 个 的 聊天 消息 由 它们 所 属 的 聊天 室 进行 控制 。 实 际 的 安全 性 将 通过 控制 聊天 室 来 提供 。 

我 们 在 这 里 要 小 心 。 开 发 者 常 犯 的 一 个 最 大 的 失误 是 : 创建 了 一 个 安全 策略 ， 它 定义 在 一 个 
高 层次 的 复合 对 象 上 ( 就 像 我 们 的 聊天 室 )， 但 后 来 却 提 供 了 一 些 通过 另 一 种 接口 访问 对 象 的 方 
式 ， 而 这 些 接口 并 不 是 以 安全 策略 定义 的 对 象 定 义 的 。 这 样 的 备用 接口 由 于 不 能 提供 可 用 的 安全 
机 制 ( 可 能 是 无 意 的 ， 或 者 是 蓄意 攻击 的 一 部 分 ) 而 违反 了 安全 策略 。 

例如 ,在 聊天 界面 中 ,我们 勾勒 出 一 个 基于 时 间 的 聊天 视图 。 我 们 可 以 将 其 扩展 为 一 个 完整 
的 基于 时 间 的 接口 ,构建 显示 最 后 30 分 钟 内 发 布 的 所 有 信息 的 视图 。 假设 实现 了 该 视图 , 我 们 提 
供 了 一 个 只 是 按时 间 戳 取 回 所 有 消息 的 视图 。 如 果 我 们 有 一 个 基于 聊天 室 的 安全 策略 ,只 在 用 户 
要 访问 聊天 室 时 检查 用 户 的 权限 , 那么 , 该 时 间 视 图 可 能 完全 使 这 一 安全 策略 无 效 ， 用户 可 以 通 
过 查看 时 间 视 图 查看 到 任意 聊天 室 的 内 容 一 一 即使 按照 安全 策略 他 们 没有 权限 查看 。 

这 就 是 使 安全 性 变 得 环 手 的 地 方 , 开发 者 需要 考虑 周全 。 这 些微 小 琐碎 的 错误 很 容易 出 现在 
系统 中 的 一 些 不 起 眼角 落 ， 然 后 ,一 切 钞 然 倒 塌 ， 所 有 的 安全 策略 都 没有 意义 了 ,系统 变 得 彻底 
不 安全 。 

现实 世界 中 就 有 大 量 这 样 的 例子 。 说 真 的 , 大 多 数 软件 病毒 利用 的 正 是 这 种 漏洞 。 软 件 中 的 
安全 系统 用 来 防止 程序 做 某 些 类 型 的 操作 , 但 在 系统 的 一 些小 角落 中 却 并 没有 考虑 如 何 与 安全 策 
略 交 互 ， 以 至 于 出 现 了 各 种 漏洞 。 

正如 开发 者 所 看 到 的 ， 确 保 仔细 全 面 地 设计 安全 策略 非常 关键 。 事 实 上 ,读者 在 本 书 中 看 到 
的 方法 并 不 是 在 实际 应 用 程序 中 所 遵循 的 过 程 。 我 们 要 做 的 是 把 安全 性 加 到 现 有 应 用 程序 中 ,而 
在 实际 应 用 中 ， 开 发 者 必须 从 一 开始 就 考虑 安全 性 ， 安 全 策略 应 该 是 设计 的 首要 内 容 之 一 。 

对 于 这 个 聊天 应 用 程序 ， 我们 将 竭尽 所 能 设计 一 种 策略 ， 就 好 像 是 为 一 个 新 应 用 程序 设计 
那样 。 我 们 将 采用 Java 版 本 的 应 用 程序 ， 因 为 这 是 一 个 比较 简单 的 聊天 应 用 程序 的 实现 。 只 需 
要 考虑 应 用 程序 中 有 哪些 视图 ， 然 后 设计 一 个 安全 策略 ,涵盖 应 用 程序 中 所 有 可 能 的 用 户 访问 
数据 的 方式 ， 并 且 要 绝对 确保 每 个 视图 的 实现 都 考虑 和 执行 了 该 安全 策略 。 尽 力 保持 简洁 ， 创 
建 如 下 三 个 角色 : 

口 普通 用 户 ， 可 以 在 聊天 室 读 取 和 发 布 消息 ; 
口 特权 用 户 ， 可 以 做 普通 用 户 能 做 的 所 有 事情 ， 还 可 以 创建 新 的 聊天 室 ; 
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口 管理 员 ， 可 以 做 特权 用 户 能 做 的 所 有 事情 ， 还 可 以 创建 新 的 特权 用 户 。 





缓冲 区 溢出 

有 一 个 已 被 广泛 利用 的 安全 缺口 ， 那 就 是 缓冲 区 溢出 。 虽 然 在 App Engine 中 开发 者 不 
必 担 心 这 种 错误 ， 但 作为 一 个 案例 研究 ， 缓 冲 区 溢出 还 是 很 有 趣 的 。 

在 大 量 的 C 代码 中 ， 数 据 会 被 读 入 缓冲 区 ， 即 一 块 预先 分 配 好 的 内 存 。 例 如 ， 如 果 要 
做 一 个 输入 框 ， 那 么 ,很 多 C 语言 框架 会 让 开发 者 传递 一 个 指向 缓冲 区 的 指针 ， 而 输入 框 
中 的 内 容 则 将 被 写 入 该 缓冲 区 。 

缓冲 区 的 大 小 是 固定 的 ， 因 为 它 在 传递 之 前 就 被 分 配 好 了 。 比 如 ， 开 发 者 有 一 个 输入 
框 ， 它 可 容纳 80 个 字符 的 字符 串 ， 那 么 就 可 以 传递 一 个 80 个 字 节 的 内 存 缓冲 区 。 

但 如 果 有 人 返回 81 个 字符 而 不 是 80 个 ， 又 会 发 生 什 么 呢 ? 或 者 ， 如 果 返 回 了 800 个 
字符 呢 ? 

这 正 是 缓冲 区 溢出 发 生 的 情况 。 攻 击 者 将 多 于 已 有 缓冲 区 空间 的 数据 填 入 到 缓冲 区 。 
如 果 开 发 者 的 代码 不 检查 长 度 ， 只 是 简单 地 复制 数据 ， 那 么 开发 者 最 终 会 用 复制 的 数据 履 
盖 其 程序 的 内 存 ， 从 而 改变 了 数据 结构 ， 黄 至 可 能 在 内 存 中 插入 新 的 代码 ， 而 这 些 插入 的 
代码 会 被 执行 ! 

就 我 们 一 直 所 讨论 的 内 容 来 看 ， 这 怎么 算是 一 个 安全 漏洞 呢 ? 这 其 中 涉及 了 安全 策略 
的 重要 方面 。 在 安全 策略 的 较 底 层 一 一 基础 的 编程 语言 和 库 所 提供 的 安全 性 的 级 别 一 一 安 
全 策略 应 该 是 没有 人 能 向 不 属于 其 的 内 存 中 写 东 西 。 但 是 ， 草 率 的 代码 实现 方法 并 没有 验 
证 是 否 遵循 了 该 策略 。 该 策略 要 求 每 个 向 内 存 中 的 写 操作 都 要 检查 该 写 操作 是 被 允许 的 ， 
但 代码 中 的 实际 检查 则 是 :“ 这 个 缓冲 区 的 起 始 地 址 是 否 对 该 调用 来 讲 是 一 个 有 效 可 用 位 
置 ? ”安全 策略 被 打破 了 , 因为 检查 只 查看 了 实际 策略 条 件 的 一 半 。 正确 的 检查 应 该 是 :“ 我 
可 以 复制 整个 字符 串 数据 到 这 个 缓冲 区 吗 ? ”该 检查 由 两 部 分 组 成 :“ 这 是 一 个 有 效 的 缓冲 
区 地 址 吗 ? 我 复制 的 数据 能 刚好 放 入 这 个 缓冲 区 吗 ? ” 





17.2.2 ”实现 聊天 角色 


App Engine 有 一 个 与 应 用 程序 相关 联 的 角色 概念 。 默 认 情 况 下 , 每 个 应 用 程序 都 有 两 个 角色 : 
管理 者 ， 以 及 正常 登录 的 用 户 。 对 于 这 些 内 置 的 角色 ,登录 认证 的 管理 非常 容易 。 在 应 用 程序 的 
配置 文件 中 ， 开 发 者 可 以 标记 某 些 网 址 为 只 允许 管理 员 使 用 。 在 5.2 节 中 ， 我 们 看 到 了 如 何 使 用 
Users 服 务 进行 配置 ， 实 现 一 个 页 面 要 求 通过 认证 的 、 登 录 的 用 户 才能 访问 ， 即 通过 在 app .yam1 
文件 中 加 入 1ogin:admin 代 赫 1ogin:require。 

对 于 更 多 类 型 的 角色 ,开发 者 需要 自己 建立 。 基 本 上 , 需要 创建 一 个 包含 角色 数据 的 持久 性 
对 象 , 然后 由 请 求 处 理 程序 取 回 角色 数据 , 并 在 生成 页 面 之 前 对 其 权限 进行 验证 。 这 就 是 聊天 应 
用 程序 下 面 所 应 做 的 事情 。 
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任何 可 以 登录 到 Google 的 人 基本 上 都 是 普通 用 户 。 因 此 ,针对 普通 用 户 页 面 , 我们 需要 实现 
的 就 是 已 经 设置 好 的 要 求 用 户 登录 。 针对 特权 用 户 和 管理 员 则 还 需要 做 其 他 的 工作 。 特权 用 户 和 
管理 员 都 能 访问 普通 用 户 所 不 能 施行 的 操作 。 因 此 将 为 这 个 应 用 程序 再 添加 两 个 新 页 面 ,以 表示 
这 两 个 新 视图 : 一 个 允许 特权 用 户 添 加 新 的 聊天 室 , 一 个 用 于 管理 员 管 理 用 户 。 我 不 打算 仔细 描 
述 这 些 页 面 的 完整 的 用 户 界面 实现 , 它们 的 形式 和 之 前 实现 用 户 界面 相同 , 我 们 只 用 占 位 符 表示 
这 些 页 面 。 这 里 最 重要 的 是 了 解 如 何 保护 这 些 网 页 ， 以 确保 它们 只 能 以 安全 策略 允许 的 方式 进行 
访问 。 

根据 我 们 的 安全 策略 , 任何 登录 的 用 户 都 可 以 访问 应 用 程序 中 的 普通 聊天 视图 页 面 。 所 以 策 
略 的 这 一 部 分 已 经 实现 , 我 们 已 经 使 用 App Engine 的 Users 服 务 要 求 用 户 登 录 , 没有 人 能 够 不 登录 
就 访问 视图 。 

为 了 能 够 实现 安全 策略 ,需要 有 一 个 机 制 能 够 识别 哪些 用 户 具有 除 默 认 的 登录 用 户 角 色 以 外 
的 角色 。 要 想 实现 该 功能 ， 需 要 给 数据 仓库 再 添加 了 一 个 新 类 型 UserRole。 该 角色 类 型 仅仅 是 

个 用 户 名 ( 登录 用 户 的 名 字 ， 作 为 登录 服务 的 返回 ) 和 一 个 包含 用 户 角 色 的 字符 串 。 该 类 型 以 

及 取 回 用 户 角 色 的 函数 的 基本 实现 如 下 所 示 : 


























































































































secure-chat/tchat.py 


class UserRole(db.Model): 
name = db.StringProperty(required=True) 
role = db.StringProperty(choices=["User", "admin", "privileged"], 
default="User") 


@staticmethod 
def GetUserRole(name): 
user_record = db.GqlQuery("SELECT * from UserRole WHERE ” + 
"name = :1", 
name)) .get() 
if user_record != None: 
return user.role 
else: 
return "User" 


这 些 代码 非常 简单 ,该 类 是 一 个 有 两 个 字符 串 字段 的 标准 的 数据 仓库 类 型 。 通 过 用 一 个 包含 可 能 
值 的 特定 列表 注释 role 字 段 ， 只 有 列表 中 的 那些 角色 允许 访问 。 任 何人 都 不 可 能 通过 一 个 错误 
的 ， 或 者 一 个 恶意 的 攻击 ， 用 一 个 无 效 的 角色 创建 用 户 。 而 且 ， 任 何不 在 数据 仓库 UserRole 记 
录 中 的 用 户 都 无 法 通过 检查 ， 因 此 会 以 默认 的 角色 User 绪 

这 种 默认 的 规则 由 GetUserRole 执 行 ， 它 为 一 个 特定 的 用 户 返 回 角 色 。 如 果 用 户 没有 被 授 
予 一 个 特定 的 角色 ， 那 么 他 们 将 在 UserRole 表 中 不 会 有 表 项 ， 因 此 ，GQL 查 询 最 终 将 引发 一 个 
IndexError。 当 发 生 IndexError 时 ，GetUserRole 最 终 会 运行 异常 处 理 代码 ， 返 回 默认 的 角 
色 User。 

这 段 代码 中 一 个 有 趣 的 事情 是 : 角色 特性 中 有 限 值 的 使 用 。 我 们 并 没有 让 role 角 色 使 用 无 
限制 的 文本 字符 串 特 性 ， 相 反 ， 我 们 特意 对 其 进行 了 限制 ， 确 保 用 户 有 一 个 有 效 的 角色 。 
GetUserRole 不 可 能 返回 应 用 程序 所 识别 的 三 种 有 效 角 色 之 外 的 内 容 。 这 一 点 看 起 来 似乎 并 不 重 





















































17.2 基本 的 安全 性 197 





要 , 但 是 当 开 发 者 实现 安全 性 时 ， 这 绝对 至 关 重 要 ,开发 者 对 所 有 细 闻 都 得 超级 偏执 。 如 果 只 有 
三 种 可 能 的 角色 ， 那 么 开发 者 可 以 绝对 确保 其 代码 中 出 现 的 只 有 三 种 可 能 的 角色 值 一 一 即便 如 
此 ， 开 发 者 仍然 得 进行 检查 。 

接 下 来 ， 一 个 角色 受 限 的 页 面 被 请 求 时 ， 我 们 需要 检查 用 户 是 否 具有 针对 该 页 面 的 正确 
角色 : 





secure-chat/tchat.py 


def ValidateUserRole(actual, required): 


if required == "admin": 
return actual == "admin" 
elif required == "privileged": 
return (actual == "admin" || actual == "privileged") 
elif required == "User": 
return True 
3) else: 


return False 

同样 ， 这 上 段 代码 非常 简单 。 但是， 就 像 通常 的 安全 性 代码 一 样 ， 它 的 编写 显得 非常 死板 。 对 于 管 
理 者 页 面 ， 我 们 只 在 用 户 是 admin 时 显示 该 网 页 ; 对 于 特权 页 面 ， 我 们 只 在 用 户 是 privileged 
或 者 admin 时 显示 该 页 面 。 即 使 是 第 三 种 角色 ，User， 虽 然 实 际 上 并 不 需要 检查 ， 我 们 也 把 它 放 
到 其 中 。 为 什么 要 如 此 死板 呢 ? 设想 以 后 增加 了 一 个 超级 管理 者 角色 ， 而 忘记 更 新 这 个 功能 。 如 
果 我 们 只 是 顺 着 代码 执行 下 来 ,没有 检测 User 就 返回 True， 那 么 需要 超级 管理 者 角色 才能 访问 
的 页 面 的 验证 请 求 最 终 会 进入 与 User 相 同 的 缺 省 情况 ， 即 允许 任何 人 访问 它 ! 我 们 特意 检查 了 
每 个 角色 ， 以 保证 没 人 通过 注入 非 标准 的 角色 来 试图 欺骗 应 用 程序 。 
于 应 用 程序 的 其 余部 分 ， 需 要 考虑 用 什么 类 型 的 用 户 界面 元 素 提 供 安 全 策略 所 需 的 能 力 。 
安全 策略 表明 特权 用 户 允 许 创 建新 的 聊天 室 , 而 我 们 的 应 用 程序 目前 还 没有 这 样 的 方法 , 所 以 需 
要 创建 一 个 新 的 页 面 ， 提 供 创 建新 聊天 室 的 功能 。 该 功能 的 实现 代码 参见 code/secure-chat/ 
new-chat.html。 

基本 的 请 求 处 理 程序 是 我 们 惯用 的 典型 的 App Engine 代 码 。 除 了 在 开始 时 的 角色 检查 ， 它 就 
是 一 个 标准 的 处 理 程序 。 除 此 之 外 ， 它 只 是 一 个 能 够 生成 标准 表格 的 处 理 程序 ， 实 现 POST 请 求 
的 提交 。 

不 同 的 是 , 在 向 用 户 显 示 页 面 之 前 ， 需 要 检查 用 户 有 必要 的 权限 。 我 们 采用 如 下 所 示 的 代码 
实现 此 功能 : 
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secure-chat/tchat.py 


class NewChatRoomHandler (webapp.RequestHandler): 
0 @login_required 
def get(self): 
user = Users.get current_user() 
© role = GetUserRole(user) 
if not ValidateRole(role, "privileged"): 
self.response.headers["Context-Type"] = "text/html1" 
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self.response.out.write(l 
"<html><head>\n" + 
"<title>Insufficient Privileges</title>\n" + 
"</head>\n" + 
"<body><h1l>Insufficient Privileges</hl>\n" + 
"<p> I'm sorry but you aren't allowed to ”+ 
"access this page</p>\n" + 
"</body></html>\n") 


else: 
self.response.headers["Content-Type"] = "text/html" 
template_values = {'title': "MarkCC's AppEngine Chat Room", 


} 
path = os.path.join(os.path.dirname(_file ), 'new-chat.htm]i') 
page = template.render(path, template_values) 
self.response.out.write(page) 


角色 检查 如 @ 所 示 。 由 于 我 们 使 用 了 几 个 基础 设施 的 方法 来 构建 角色 代码 ， 所 以 ,检查 角色 并 不 
难 。 只 要 调用 GetUserRole 取 回 用 户 的 角色 ， 然 后 调用 ValidateRole 验 证 该 用 户 是 否 具有 访问 
该 网 页 的 权限 即 可 。 我 们 还 使 用 了 一 个 非常 好 的 快捷 方式 , 没有 去 显 式 地 检查 用 户 是 否 确实 已 经 
登录 了 ， 而 是 使 用 了 O@ 处 的 装饰 器 ( decorator )。 装 饰 髓 是 Python 的 一 个 标准 功能 (Java 也 有 , 在 
Java 中 称 为 注解 )， 它 允许 开发 者 给 代码 附加 元 数据 。 在 这 个 例子 中 ， 该 装饰 器 ( 由 App Engine 
提供 ) 告诉 网 络 应 用 框架 ,该 方法 应 该 只 有 在 用 户 已 经 登录 时 才能 调用 ， 如果 用 户 没有 登录 ， 自 
动 将 用 户 重 定向 到 登录 页 面 。 

简单 来 看 , 这 些 功能 可 能 看 起 来 已 经 足够 了 。 但 事实 上 , 要 建立 一 个 正确 的 系统 , 这 还 不 够 。 
从 用 户 界面 方面 来 看 ， 如 果 用 户 没有 权限 ， 他 就 不 能 进入 管理 页 面 ， 而 且 如 果 没 有 必要 的 角色 ， 
用 户 也 就 不 能 创建 新 的 聊天 室 ， 所 以 这 应 该 是 安全 的 。 

但 想 要 破坏 系统 的 人 并 不 一 定 要 遵守 其 用 户 界 面 使 用 方式 。 如 果 要 进行 修改 , 应 用 程序 会 向 
服务 器 提交 一 个 POST 请 求 。 狐 独 的 攻击 者 可 能 会 注意 到 特权 用 户 ， 并 看 到 用 于 POST 管 理 者 的 特 
权 级 修改 的 URL， 然 后 ， 该 攻击 者 直接 向 此 URL 提 交 一 个 POST 请 求 。 因 此 ， 该 页面 的 GET 处 理 程 
序 和 更 新 的 POST 处 理 程序 都 需要 通过 验证 过 程 来 保护 ， 以 保证 只 有 适当 的 角色 的 用 户 才能 提交 
相应 的 请 求 。 

所 以 ，POST 处 理 程序 与 GET 处 理 程序 需要 以 完全 相同 的 方式 检查 权限 。 




























































































secufre-chat/tchat.py 


class NewChatRoomPostHandler (webapp.RequestHandler): 
@login_required 
def post(self): 
User = Users.get_current_user() 
role = GetUserRole(user) 
if not ValidateRole(role, "privileged"): 
self.response.headers["Context-Type"] = "text/html" 
self.response.out.write(l 
"<html><head><title>Insufficient Privileges</title></head>\n" + 
"<body><h1l>Insufficient Privileges</hl>\n" + 
"<p> I'm sorry but you aren't allowed to access this page</p>\n" + 
"</body></html>\n") 





else: 
newchat = cgi.escape(self.request.get("newchat")) 
CreateChat(user, newchat) 
self.response.out.write( 
"<html><head><title>Chat Room Created</title></head>\n" + 
"<body><h1>Chat Room Created</h1>Nn” + 
"<p> New chat room %s created.</p>\n" 
"</body></html>\n" % newchat) 


与 创建 聊天 室 的 方式 类 似 , 我 们 将 使 用 有 权限 检查 的 表单 去 创建 新 的 特权 用 户 。 要 成 为 一 个 
特权 用 户 , 必须 由 管理 员 授予 该 用 户 特权 角色 。 所 以 就 像 在 新 聊天 室 中 一 样 , 我 们 创建 了 一 个 GET 
处 理 程 序 ， 生 成 表单 ; 还 创建 一 个 POST 处 理 程 序 ， 该 程序 实际 上 完成 了 创建 特权 用 户 的 工作 。 

综 上 所 述 , 这 就 是 安全 性 的 基本 道理 : 定义 一 个 策略 ,然后 建立 执行 该 策略 的 系统 。 基 本 思 
想 确实 不 复杂 ， 开 发 者 在 系统 中 定义 哪些 对 象 可 以 访问 ， 谁 可 以 查看 /修改 它们 ， 以 及 以 何 种 方 
式 查看 /修改 。 这 就 是 开发 者 的 安全 策略 。 然 后 ， 开 发 者 要 进行 检查 ， 以 确保 这 一 策略 得 到 遵守 。 
可 是 , 现实 情况 是 , 实现 一 个 安全 系统 极其 困难 。 开 发 者 需要 知道 所 提供 给 用 户 的 每 一 个 操作 的 
影响 , 无 论 是 直接 的 还 是 间接 的 , 并 且 , 开发 者 需要 确保 其 代码 实现 在 任何 情况 下 都 能 严格 地 遵 
守 所 制定 的 安全 和 集 略 。 

到 目前 为 止 , 我 们 谈论 的 主要 内 容 是 一 个 协作 式 系 统 的 简单 安全 性 , 即 假设 该 系统 的 用 户 是 
协作 的 ， 而 不 是 主动 试图 破坏 或 者 禁用 系统 的 。 实 现 这 样 的 系统 已 经 很 难 了 , 但 还 没有 完全 反应 
现实 ,因为 除 此 之 外 , 还 有 人 会 试图 以 破坏 开发 者 的 系统 为 乐 。 因 此 ,开发 者 需要 考虑 一 些 更 复 
杂 的 情形 ; 保护 自己 免 受 攻击 。 在 本 章 的 其 余部 分 , 我 们 将 了 解 一 个 恶意 用 户 可 能 用 哪些 基本 攻 
击 方法 试图 禁用 系统 ， 以 及 开发 者 可 以 用 什么 机 制 来 保护 其 系统 免 受 这 些 攻击 。 

17.3 ”高 级 安全 性 

安全 性 的 更 复杂 的 一 个 方面 是 防御 攻击 (attack )。 攻击 是 有 人 未 经 安全 策略 允许 就 尝试 访问 
数据 或 者 进行 更 改 ， 以 及 阻碍 他 人 按照 安全 策略 允许 的 方式 行事 。 

攻击 可 能 非常 狐 独 且 富 有 想象 力 。 我 们 没有 办 法 完整 讨论 开发 者 的 服务 可 能 受到 的 所 有 攻击 
方式 ， 只 是 概述 一 些 典型 例子 ， 涉 及 攻击 可 能 使 用 的 基本 通用 的 技术 。 

从 广义 上 讲 ， 可 以 按照 攻击 试图 要 做 什么 操作 进行 分 类 。 

口 直接 攻击 ( Direct Attack ) 

这 种 攻击 会 欺骗 系统 去 实施 原本 不 允许 做 的 事情 。 基 本 上 ， 这 类 攻击 并 非 试图 基于 网 络 
基础 设施 进行 某 种 精细 的 欺骗 ， 而 是 找到 开发 者 的 安全 策略 的 缺陷 ， 然 后 利用 这 些 缺 陷 
实现 攻击 。 我 们 将 在 17.3.1 节 中 更 详细 地 了 解 这 种 攻击 。 

口 跨 站 点 脚本 攻击 ( Cross-site Scripting Attack ) 

跨 站 点 脚本 攻击 ( XSS ) 非常 常见 ， 也 十 分 危险 。 在 XSS 中 ,攻击 者 在 其 请 求 中 包括 一 些 
HTMIL 页 面 和 JavaScript 脚 本 。 如 果 开 发 者 允许 用 户 提 交会 直接 出 现在 应 答 页 面 中 的 内 容 ， 
而 没有 做 任何 验证 ,那么 攻击 者 就 能 够 欺骗 应 用 程序 ， 实 现 他 们 想 做 的 几乎 任何 事情 。 
这 个 聊天 应 用 程序 非常 容易 受到 这 种 攻击 : 因为 不 检查 聊天 消息 的 内 容 ， 攻 击 者 就 可 以 
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在 聊天 消息 中 插入 HTML 肢 本 标记 ,该 消息 可 能 导致 攻击 者 欺骗 其 他 用 户 的 浏览 器 执行 请 
求 。 从 而 ,攻击 者 可 以 伪装 成 任何 其 他 用 户 ! 我 们 将 在 后 续 页 面 中 的 17.3.2 节 中 ， 了 解 如 
何 保护 自己 免 受 XSS 攻 击 。 
口 窃听 攻击 ( Eavesdropping Attacks ) 
这 种 攻击 (包括 了 其 常见 的 变种 “中 间 人 ”攻击 ) 试图 使 其 位 于 通过 身份 验证 的 用 户 和 系统 
之 间 ， 查 看 通过 身份 验证 的 用 户 有 权 访 问 而 攻击 者 无 权 访问 的 数据 。 这 种 攻击 也 可 以 用 
来 窃取 证 书 ， 也 就 是 说 ， 找 到 攻击 者 可 以 利用 的 信息 ， 从 而 把 自己 伪装 成 一 个 有 效 的 用 
户 。 这 种 攻击 要 依靠 开发 者 自己 来 防护 是 非常 困难 的 ， 因 此 ， 加 密 协 议 就 是 设计 来 帮助 
解决 这 个 问题 的 。 后 续 章 节 将 介绍 如 何 使 用 SSL ( 安全 套 接 字 层 ) 实现 窃听 防御 。SSL 并 
不 是 一 种 完整 的 防御 ， 但 作为 一 种 精心 设计 且 比 较 周 密 的 安全 策略 中 的 一 个 组 成 部 分 ， 
它 确实 是 一 个 比较 好 的 初始 方案 。 
拒绝 服务 攻击 ( DoS，Denial-of-Service Attack ) 
与 我 们 已 经 讨论 的 其 他 攻击 相 比 ， 在 攻击 方式 上 ， 拒 绝 服 务 攻 击 并 不 算是 真正 的 攻击 。 
它 不 会 尝试 访问 或 者 擅自 改变 数据 ， 而 是 试图 阻止 授权 用 户 访 问 他 们 应 该 有 权 访 问 的 数 
据 。 拒 绝 服务 攻击 最 常见 的 形式 是 让 成 千 上 万 感染 了 病毒 的 计算 机 ， 向 某 个 应 用 程序 发 
送 庞大 的 伪造 请 求 。 应 用 程序 不 得 不 花费 大 量 的 时 间 来 处 理 这 些 伪造 请 求 ， 使 得 有 效 的 
用 户 无 法 实际 访问 任何 内 容 。 
要 特别 小 心 防范 对 开发 者 的 App Engine 代 码 的 DoS 攻 击 ， 因 为 开发 者 要 为 用 来 处 理 请 求 的 
CPU 时 间 付 费 。 开 发 者 花 在 一 个 无 效 的 请 求 上 的 每 毫秒 的 时 间 都 可 能 是 昂贵 的 ， 一 个 请 
求 耗费 的 额外 1 毫秒 CPU 时 间 可 能 在 典型 的 DoS 攻 击 中 很 容易 就 累计 成 额外 的 1 小 时 CPU 
时 间 。 和 幸运 的 是 ，App Engine 的 服务 器 管理 者 会 监测 流量 模式 ， 从 而 能 够 发 现 DoS 攻 击 ， 
而 且 通 常 在 攻击 到 达 开 发 者 的 应 用 程序 之 前 就 会 关闭 该 攻击 。 但 是 ， 开 发 者 还 是 应 该 有 
所 警惕， 总 是 尽早 地 检查 所 收 到 的 请 求 ， 进 行 各 类 最 基本 的 验证 〈 在 开发 者 做 任何 其 他 
事情 之 前 进行 )， 并 且 需 要 拒绝 无 效 的 请 求 ， 不 浪费 任何 资源 。 我 们 将 在 17.3.4 节 中 ， 简 
要 地 了 解 一 些 由 App Engine 提 供 的 工具 ， 帮 助 开 发 者 处 理 DoS 攻 击 。 


17.3.1 直接 攻击 


直接 攻击 是 最 容易 防御 的 攻击 。 直 接 攻击 直 蕉 了 当地 企图 欺骗 开发 者 的 系统 , 让 用 户 执行 他 
们 无 权 执行 的 某 些 操 作 。 例如 , 在 上 面 的 例子 中 , 攻击 者 可 能 尝试 未 经 批准 就 直接 通过 发 送 POST 
命令 给 服务 器 ， 使 用 创建 聊天 室 的 对 话 框 。 

对 于 这 种 攻击 类 型 , 我们 的 防护 方式 是 提供 精心 定义 的 安全 性 策略 ,并 仔细 实现 该 策略 。 这 
是 一 种 最 容易 防御 的 攻击 一 一 虽然 如 此 ,实现 起 来 也 可 能 非常 困难 。 正 如 上 一 节 中 所 讨论 的 那样 ， 
我 们 需要 确保 每 一 个 处 理 程序 总 是 检查 用 户 的 身份 验证 ， 检 查 用 户 是 否 有 权限 执行 特定 的 操作 。 
另外 ,最 重要 的 是 ， 保 证 被 请 求 的 操作 是 有 效 的 。 大 多 数 系统 中 最 常见 、 最 成 功 的 攻击 类 型 就 是 
使 用 无 效 请 求 的 直接 攻击 。 如 果 想 要 使 其 系统 变 得 安全 ， 就 要 无 一 遗漏 地 检查 所 有 的 请 求 。 允 许 
无 效 请 求 就 意味 着 提供 了 一 个 漏洞 ,而 一 个 足够 聪明 的 攻击 者 能 够 找到 这 个 漏洞 , 并 将 其 尽量 放 
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大 。 例 如 , 在 聊天 室 例子 中 ， 必 须 检 查 发 送 消息 的 用 户 名 称 ， 确 保 用 户 确实 已 经 登录 ， 确 认 他 们 
试图 发 布 消息 的 聊天 室 确实 存在 ， 并 确认 他 们 的 消息 被 正确 地 格式 化 为 XML 请 求 。 如 果 这 些 内 
容 中 有 任何 一 点 不 符合 ， 那 么 应 用 程序 都 不 应 该 继续 处 理 该 请 求 。 














17.3.2 ” 跨 站 点 脚本 


跨 站 点 脚本 是 一 种 利用 云 应 用 程序 开发 者 的 草率 之 处 而 进行 的 攻击 。 由 于 HTML 页面 由 简单 
文本 和 易于 输入 的 标记 所 组 成 ， 所 以 请 求 的 主体 可 能 会 包含 HTML 标 记 。 然 后 ， 使 用 主体 包含 的 
HTML 标 记 ， 可 以 提供 JavaScript 代 码 。 

假如 用 户 发 送 包含 如 下 内 容 的 聊天 消息 ， 会 发 生 什么 呢 ? 

Hi there <script language="javascript"> print("JavaScript!");</script> 
用 户 的 显示 屏 上 会 显示 聊天 消息 “Hi there JavaScript!1” 一 一 但 是 打印 单词 “JavaScript” 的 JavaScript 
代码 会 在 用 户 计算 机 上 执行 。 

还 有 一 种 密切 相关 的 跨 站 点 脚本 攻击 , 试图 在 服务 器 上 运行 代码 。 这 种 攻击 最 常见 的 形式 称 
为 SQL 注入 。 具 体 来 说 ，SQL 注 入 并 不 是 App Engine 的 问题 ( 因为 开发 者 并 不 使 用 SQL ), 但 它 确 
实 是 一 个 非常 典型 的 一 般 性 攻击 。 

在 SQL 注 入 攻击 中 ,攻击 者 向 查询 语句 中 作为 字段 的 表单 发 送 了 一 个 字符 串 。 例如， 在 许多 
系统 中 , 用 户 在 登录 时 ,会 被 要 求 在 表单 中 输入 用 户 名 和 密码 ， 然 后 系统 将 执行 一 个 SQL 查询 取 
回 正确 的 密码 。 系 统 会 做 一 个 查询 ， 如 : SELECT password FROM Users WHERE name =$1，, 
然后 ， 用 户 可 以 提供 一 个 用 户 名 ， 如 me;DROP TABLE *.。 如 果 用 户 的 用 户 名 字段 值 在 查询 语句 
中 被 直接 使 用 ， 会 执行 为 : SELECT password FROM User WHERE name=me; DROP TABLE *.。 
攻击 者 知道 该 字符 串 将 直接 被 传递 给 SQL 查询 语句 ,所 以 ,可 以 创建 一 个 字符 串 执 行 其 他 具有 破 
坏 性 的 SQL 语句 。 

防御 这 两 种 攻击 的 方式 很 明确 ,就 是 总 是 清空 用 户 的 输入 。 也 就 是 说 ， 当 开发 者 从 一 个 用 户 
那里 得 到 输入 时 ， 总 是 获取 该 输入 ,并 进行 清空 过 程 ， 消 除 所 有 元 字符 。 为 了 防止 有 人 在 开发 者 
的 HTML 中 注入 JavaScript， 开 发 者 应 该 确保 所 有 < 字符 都 被 XML 文本 字符 替换 ， 如 &lt。 为 防止 
有 人 注入 SQL， 开 发 者 需要 确保 其 输入 不 包含 类 似 引 用 、 查 询 元 字符 或 语句 结束 符 ; 如 果 有 ， 这 
些 字符 就 需要 转 义 。 

App Engine 提 供 了 可 以 用 来 防御 XSS 类 型 攻击 的 工具 。 如 果 开 发 者 使 用 Python， 网 络 应 用 框 
架 的 cgi 模 块 中 有 一 个 函数 ， 只 要 调用 cgi .escape(Cinput_string) ， 开 发 者 就 不 必 担 心 这 样 的 
XSS 攻 击 了 。 在 开发 者 的 模板 中 , 开发 者 也 可 以 在 输出 端 添 加 一 个 过 滤器 进行 转 义 。 如 果 给 Django 
模板 中 的 任意 变量 追加 了 lescape， 该 变量 的 值 就 会 针对 HTML 进行 正确 转 义 ， 防 止 XSS 攻 击 。 
对 于 Java， 则 稍微 复杂 一 些 。 如 果 开 发 者 正在 使 用 GWT 进 行 所 有 工作 ， 就 已 经 被 保护 了 。GWT 
处 理 了 XSS 的 所 有 情况 ,并 摆脱 了 使 用 RPC 做 的 所 有 事情 中 的 问题 。 如 果 开 发 者 不 使 用 GWT, 那 
么 处 理 XSS 的 方式 取决 于 开发 者 使 用 的 库 , 但 是 , 几乎 每 个 框架 都 提供 了 一 些 内 置 的 方法 。 例 如 ， 
如 果 开 发 者 使 用 Java Server Pages ( 这 是 和 我 们 在 第 6 章 中 使 用 的 Django 模 板 系统 的 Java 版 本 相 类 
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似 的 类 型 )， 那 么 有 一 个 标准 函数 c:out 用 于 打印 值 ， 只 要 开发 者 给 c:out 调 用 添加 一 个 属性 
escapeXxm]="true"， 它 就 会 自动 负责 处 理 好 字符 串 。 


17.3.3 ”窃听 攻击 


穷 听 攻击 非常 微妙 ,也 非常 难 对 付 。 这 种 攻击 不 是 试图 对 开发 者 的 系统 做 任何 事情 ,而 是 隐 
藏 在 后 台 并 进行 观察 。 为 防御 窃听 攻击 , 开发 者 可 以 做 的 主要 工作 就 是 设计 一 个 精细 的 、 彻 底 的 
安全 策略 ， 并 在 所 有 特权 通信 中 都 使 用 加 密 通 道 。 

有 几 种 提供 加 密 通 道 的 方法 。 最 简单 的 就 是 让 App Engine 为 开发 者 处 理 加 密 ， 即 告诉 App 
Engine 对 某 个 特定 的 URL 的 所 有 请 求 强制 使 用 SSL( 安全 套 接 字 层 , 一 种 标准 的 互联 网 加 密 系统 )。 
要 告诉 App Engine 为 一 个 特定 的 URL 使 用 SSL， 只 需 在 该 URL 的 app.yam1 条 目 中 添加 secure: 
always 行 。 

谈 到 加 密 ， 我 可 以 给 读者 一 个 绝对 重要 的 忠告 : 不 要 自己 实现 。 如 果 只 要 在 app.yam1 中 使 
用 secure 条 目 就 可 以 实现 加 密 ， 那 么 就 要 这 样 做 。 如 果 由 于 某 种 原因 ， 开 发 者 需要 更 复杂 的 功 
能 ， 那 么 ， 可 以 找 一 种 广泛 使 用 的 、 支 持 较 好 的 提供 加 密 服务 的 库 。Python 和 Java 中 都 有 扩展 的 
加 密 库 ， 开 发 者 可 以 使 用 它们 在 App Engine 中 做 加 密 工 作 。 所 以 ， 就 使 用 这 些 加密 库 吧 ! 要 实现 
正确 的 加 密 非 常 坏 手 。 如 果 开 发 者 实现 了 自己 的 加 密 系 统 , 那么 , 几乎 可 以 确定 其 中 肯定 有 错误 。 
作为 一 个 加 密实 现 程序 , 开发 者 必须 绝对 保证 一 切 完全 正确 , 然而 这 其 中 有 许多 微妙 之 处 ,开发 
者 想 要 自己 做 到 一 切 完全 正确 ,几乎 是 不 可 能 的 。 即 使 由 许多 位 专家 一 起 建立 的 加 密 系统 ,通常 
也 会 有 错误 。 当 有 人 试图 建立 一 个 安全 的 加 密 系 统 时 ， 需 要 找 出 其 计划 中 的 每 一 个 可 能 的 漏洞 ， 
并 补 上 这 些 漏洞 , 但 是 ,作为 一 个 试图 打破 加 密 系 统 的 攻击 者 ,他 只 需要 找到 一 个 漏洞 即 可 。 攻 
击 者 的 工作 远 比 开 发 者 的 工作 更 容易 ! 因此 , 请 使 用 其 他 人 已 经 编写 好 的 通过 测试 的 、 认 真 分 析 
过 的 ， 并 通过 真实 考验 进行 了 压力 测试 的 系统 。 


17.3.4 拒绝 服务 攻击 


正如 我 之 前 解释 过 的 , 拒绝 服务 攻击 是 使 用 大 量 请 求 来 堵塞 开发 者 网 站 的 攻击 方式 。 请 求 可 
能 是 完全 合法 的 , 也 可 能 是 无 效 的 。 无 论 其 是 否 合法 , 攻击 目的 都 是 迫使 网 络 应 用 程序 花费 大 量 
时 间 处 理 洪水 一 般 的 请 求 ， 从 而 导致 合法 用 户 无 法 使 用 应 用 。 

这 种 攻击 不 仅 可 以 通过 负载 使 网 站 无 法 访问 , 而 且 还 会 浪费 开发 者 的 资金 。 在 App Engine 中 ， 
开发 者 要 为 其 使 用 的 资源 付费 ， 直 到 用 完 所 有 配额 。 一 旦 超出 配额 ,就 不 会 产生 更 多 的 账单 ,但 
应 用 程序 也 将 被 完全 关闭 。 所 以 ， 确 实 要 防御 这 样 的 攻击 。 

防御 DoS 攻 击 的 一 个 要 点 就 是 尽快 验证 请 求 ， 并 拒绝 无 效 请 求 。 如 果 开发 者 每 秒 被 10 000 个 
请 求 击 中 , 那么 这 种 方法 不 会 有 多 大 用 处 ,但 对 于 较 小 的 攻击 ， 则 情况 明显 会 得 到 改善 。 当 开发 
者 收 到 一 个 请 求 时 ， 应 该 做 的 第 一 件 事情 就 是 检查 该 请 求 是 否 是 有 效 的 。( 如 果 开 发 者 使 用 
GWT, 将 由 框架 为 开发 者 处 理 好 检查 工作 ，GWT 的 RPC 会 进行 请 求 的 自动 验证 。) 开发 者 应 该 确 
保 尽 量 尽快 地 完成 这 项 工作 : 如 果 每 一 个 请 求 应 该 有 两 个 头 字 段 , 那么 在 开发 者 花 时 间 验 证 这 些 
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字段 的 内 容 之 前 , 首先 检查 是 否 有 这 两 个 字段 。 如 果 和 遗漏 了 一 个 或 追加 了 一 个 额外 的 字段 ,就 可 
以 拒绝 请 求 ， 而 无 需 花费 更 多 的 时 间 。 

如 果 开 发 者 面 对 的 是 一 个 真正 的 DoS 攻 击 ， 那 么 通常 会 看 到 来 自 极 少数 趾 地址 的 消息 洪流 。 
这 些 了 表示 的 通常 是 一 组 已 经 被 攻击 者 征用 的 ， 并 被 迫 向 开发 者 发 送 请 求 的 计算 机 。App Engine 
提供 了 非常 方便 的 阻塞 消息 洪流 的 方式 。 在 应 用 程序 配置 中 ， 开 发 者 可 以 声明 一 个 黑 名 单 
( blacklist )， 就 是 很 多 耻 地 址 或 了 下地 址 范围 的 列表 ， 这 些 地 址 会 被 App Engine 服 务 器 阻 蹇 。 使 用 
DoS 黑 名 单 ，App Engine 会 在 请 求 到 达 开发 者 的 应 用 程序 之 前 就 阻塞 它们 ， 从 而 保护 开发 者 不 在 
攻击 者 的 请 求 上 浪费 宝贵 的 资源 。 

App Engine 的 DoS 服 务 非常 新 ， 很 可 能 会 迅速 发 展 。 在 当前 App Engine 版 本 中 ， 开 发 者 通过 
在 其 应 用 程序 配置 中 加 入 一 个 文件 进行 DoS 服 务 配 置 ， 该 文件 声明 了 黑 名 单 的 内 容 。 在 Python 应 
用 程序 中 ， 开 发 者 创建 一 个 文件 名 为 dos .yam1 的 文件 ， 该 文件 包含 黑 名 单条 目 列 表 。 不幸 的 是 ， 
这 些 条 目 当前 完全 不 可 读 ， 它 们 是 基于 称 为 CIDR ( 无 类 域 间 路 由 ，classless inter-domain routing ) 
的 标准 的 了 P 路 由 符号 实现 的 。 开 发 者 需要 查找 CIDR 符 号 才能 够 编写 这 个 文件 。 例如 , 要 表明 “所 
有 以 192.168.0 开 始 的 地 址 ”， 开 发 者 应 该 写 为 “192.168.0.1/24”。 

因此 ， 例 如 ， 在 Python 中 ， 如 果 开 发 者 受到 来 自 包 含 192.168.72.12 的 卫 网 络 区 域 的 DoS 攻 击 ， 
那么 ， 应 该 在 dos .yam1 中 加 入 以 下 内 容 : 


blacklist: 
- subnet: 192.168.72.12/22 


我 说 过 ，DoS 保 护 服务 是 App Engine 的 一 个 新 增 功能 ， 所 以 当 读者 阅读 到 这 里 的 时 候 ， 该 服 
务 可 能 已 经 有 所 变化 。 但 是 ,基本 概念 是 相同 的 : 开发 者 定义 谁 需 要 被 阻塞 ， 并 将 其 放 到 开发 者 
的 应 用 程序 的 配置 文件 中 。 至 于 有 关 详 情 ， 确 实 需 要 查看 App Engine 网 站 上 最 新 的 文档 。 

现在 , 我 们 知道 了 云 应 用 程序 可 能 会 面临 的 问题 。 在 本 节 中 , 我 们 已 经 看 到 了 开发 者 需要 考 
虑 的 威胁 一 一 网 络 上 的 恶意 攻击 者 可 能 攻击 开发 者 的 服务 的 方式 , 以 及 开发 者 可 以 如 何 保护 自己 
免 受 这 些 攻击 。 


17.5 参考 文献 和 资源 


口 “CIDR 符 号 ”，http://en.wikipedia.org/wiki/CIDR_notation。 
Wikipedia 上 的 一 篇 有 关 标 准 IP 地 址 符号 的 文章 , 用 于 管理 IP 地 址 块 , 该 内 容 被 App Engine 
的 拒绝 服务 保护 系统 所 使 用 。 

口 OpenSSL, http://www.openssl.org/。 
一 个 标准 的 、 被 广泛 使 用 的 安全 套 接 字 层 的 实现 。 该 网 站 包括 了 SSL 库 的 漂亮 的 实现 以 及 
丰富 的 文档 ， 还 有 底层 SSL 协 议 ， 还 介绍 了 如 何 正确 地 使 用 它 。 

口 通用 网 关 接 口 (CGI ) ，http:/www.wWw3.org/CGI/。 

CGI 的 官方 标准 和 文档 。 

口 “理解 拒绝 服务 攻击 ”，http://www.us-cert.gov/cas/tips/ST04-015.html。 
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一 篇 来 自 美国 计算 机 应 急 准 备 组 的 优秀 文章 ， 解 释 各 种 拒绝 服务 攻击 的 机 制 ， 以 及 如 何 
识别 、 抵 御 和 应 对 这 些 攻 击 。 








17.4 小结 


在 这 一 章 中 , 我 们 已 经 很 浅显 地 了 解 了 一 下 安全 性 。 安 全 性 是 一 个 重要 的 、 复 杂 的 话题 , 超 
过 了 所 有 构建 网 络 服务 的 其 他 方面 。 正如 所 看 到 的 , 从 概念 上 建立 一 个 安全 的 应 用 程序 或 服务 并 
不 困难 ， 但 是 ， 实 际 开发 中 这 几乎 是 不 可 能 的 。 

任何 安全 系统 的 起 点 都 是 安全 策略 一 一 描述 开发 考 的 应 用 程序 /服务 管理 的 对 象 ， 
许 访问 /管理 每 个 对 象 的 规则 。 我 们 已 经 看 到 了 一 个 聊天 应 用 程序 的 安全 策略 的 例子 ， 这 个 例子 
是 根据 聊天 室 和 用 户 定 义 的 。 仔 细 设 计 安全 策略 很 关键 ， 我 们 看 到 了 一 个 例子 ， 妮 供 "个 不 使 用 
安全 策略 的 视图 可 以 完全 否定 这 个 安全 策略 。 

开发 者 有 了 一 个 设计 良好 的 安全 策略 后 ， 就 需要 实现 它 。 认 真 做 到 这 一 点 很 关键 。 开 发 者 需 
要 考虑 用 户 可 能 与 应 用 系统 交互 的 所 有 方面 , 并 确保 系统 能 够 仔细 地 保护 数据 , 并 且 总 是 验证 用 
户 执行 的 是 安全 策略 允许 的 特定 操作 。 开 发 者 需要 坚持 这 样 ， 应 用 程序 需要 检查 、 检 查 、 再 检查 
用 户 的 证 书 /身份 验证 。 

开发 者 设计 其 系统 时 需要 有 这 样 的 想法 : 它 肯 定 会 受到 攻击 。 开 发 者 需要 意识 到 所 开发 的 系 
统 可 能 受到 的 不 同类 型 的 攻击 ， 实 现 防止 这 些 攻 击 的 安全 措施 ， 监 视 应 用 程序 ， 检 测 主动 攻击 ， 
如 DoS， 并 且 ， 当 检测 到 攻击 时 ， 安 排 好 相应 的 工具 进行 应 对 。 
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到 目前 为 止 ， 我 们 几乎 完全 侧重 于 如 何 编写 Google App Engine 应 用 程序 。 这 是 因为 使 用 App 
Engine 工 作 中 最 难 的 部 分 就 是 实现 应 用 程序 。 当 开发 者 已 经 能 够 使 应 用 程序 工作 之 后 ， 管 理应 用 
程序 的 确 很 容易 。 

开发 者 确实 需要 管理 自己 的 App Engine 服 务 和 应 用 程序 。 虽 然 这 很 容易 ， 但 需要 持续 进行 。 
本 章 将 快速 介绍 一 下 App Engine 控 制 面 板 提供 的 可 用 工具 ,将 介绍 开发 者 如 何 监视 其 使 用 的 资源 
量 , 如 何 扫 描 自己 的 应 用 程序 中 存储 的 数据 以 找 出 问题 ,以 及 如 何 看 到 谁 在 哪里 使 用 开发 者 的 应 
用 程序 等 各 种 问题 。 

















18.1 监视 


监视 开发 者 的 应 用 程序 只 是 指 查看 应 用 程序 是 如 何 被 使 用 的 ， 以 及 应 用 程序 使 用 了 哪 类 资 
源 。 在 App Engine 中 ， 查 看 开发 者 的 应 用 程序 到 底 发 生 了 什么 确实 很 容易 。 只 要 开发 者 访问 
http://appengine.google.com 并 登录 ， 就 会 得 到 一 个 其 已 经 部 署 的 应 用 程序 列表 。 通 过 点 击 应 用 程 
序 的 名 字 ， 开 发 者 可 以 查看 其 中 任何 一 个 应 用 程序 。 

当 开发 者 点 击 一 个 应 用 程序 时 ,会 被 带 到 该 应 用 程序 的 主 App Engine 控 制 面板 ， 有 一 个 向 开 
发 者 显示 其 应 用 程序 的 仪表 板 ( dashboard ) 的 视图 。 仪表 板 展现 开发 者 可 能 关心 的 数据 的 简要 概 
述 。 我 们 可 以 在 图 18-1 中 看 到 我 的 Java 聊 天 应 用 程序 的 App Engine 控 制 面板 的 一 个 例子 。 正 如 所 
示 ， 虽 然 该 程序 看 起 来 没有 被 大 量 使 用 ， 但 是 ， 使 用 信息 都 在 控制 面板 中 。 

在 顶部 ， 开 发 者 会 看 到 一 个 图 表 ， 显 示 该 应 用 程序 每 秒 处 理 的 平均 请 求 数量 。 对 于 我 的 Java 
聊天 程序 而 言 ， 可 以 看 到 ,使 用 量 很 少 ， 其 平均 使 用 率 是 零 ! 真正 连续 使 用 一 段 时 间 后 ， 我 能 看 
到 ， 过 去 一 段 时 间 的 使 用 负载 略微 提升 ， 达 到 约 每 秒 两 个 查询 。 

顶部 的 图 表 可 以 向 开发 者 显示 很 多 不 同 内容 的 摘要 。 在 它 的 左上 方 ， 有 一 个 下 拉 菜 单 ， 开 发 
者 可 以 选择 想 要 查看 的 视图 。 除 了 每 秒 的 请 求 数 之 外 ,还 可 以 看 到 用 于 处 理 每 个 请 求 的 时 间 的 图 、 
错误 的 数量 、 每 个 请 求 的 带宽 、 每 秒 的 CPU 使 用 量 、 以 及 配额 拒绝 的 数量 ( 即 ， 因 为 开发 者 使 
用 完 所 有 的 App Engine 资 源 而 被 拒绝 的 请 求 )。 例如， 在 图 18-2 中 ， 可 以 看 到 每 个 请 求 花费 了 多 
少时 间 的 视图 。 根 据 该 视图 ， 当 我 使 用 聊天 软件 时 ， 应 用 程序 平均 每 个 请 求 所 用 的 时 间 约 在 24 
毫秒 左右 。 
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Goosle app engine markccGgmallcom | My Account | Holp | San out 
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图 18-1 JAVA 聊天 应 用 程序 的 控制 面板 





Miliseconds/Request 外 6hrs| 12hrs| 24 hrs| 2days| 4days|7days| 14 days | 30 days | 











图 18-2 ”每 个 请 求 的 CPU 时 间 视 网 


在 该 图 的 下 方 ， 有 一 个 更 详细 的 数据 集合 。 

口 实例 
每 个 正在 运行 开发 者 的 处 理 程序 的 进程 称 为 一 个 实例 。 该 图 下 方 有 一 条 线 ， 告 诉 开发 者 
其 应 用 程序 有 和 多少 个 实例 ,处 理 查 询 的 速度 是 多 快 ， 以 及 使 用 了 多 少 内 存 。 我 的 Java 聊 天 
程序 一 般 运 行 一 两 个 实例 , 主要 是 由 App Engine 云 中 的 随机 因素 决定 的 , 和 负载 无 关 。( 一 
般 情 况 下 ， 开 发 者 所 得 到 的 实例 的 数量 与 开发 者 的 应 用 程序 的 负载 成 正比 。 在 这 个 例子 
中 ， 负 载 很 小 ， 一 个 或 者 两 个 实例 实际 上 是 随机 的 。) 我 的 应 用 程序 平均 每 秒 大 约 两 个 请 
求 ， 所 以 有 一 个 实例 时 ， 它 显示 的 平均 每 秒 查 询 约 为 2; 有 两 个 实例 时 ， 它 们 每 个 平均 大 
约 每 秒 1 个 查询 。 
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应 用 程序 实例 的 平均 延迟 时 间 一 一 也 就 是 说 ， 从 它们 收 到 消息 ， 到 可 以 开始 处 理 消 息 时 
真正 花费 的 时 间 只 有 17 毫 秒 。 但 是 ， 这 些 实例 每 个 使 用 65 兆 内 存 ! 从 字面 上 看 ， 这 
听 起 来 很 疯狂 , 但 请 记 住 , 我 们 正在 看 一 个 Java 应 用 程序 ， 所 以 这 个 数字 包括 整个 JVM 和 
它 加 载 的 所 有 类 库 。 在 内 存 方面 ，Java 并 不 算 高 效 。 我 的 Python 聊天 室 的 平均 值 约 是 其 五 
分 之 一 。 但 是 , 考虑 到 App Engine 提 供给 我 的 资源 的 数量 , 那 确实 不 是 一 个 大 问题 一 一 应 
该 不 会 影响 开发 者 选择 要 使 用 哪 种 语言 。 
口 账单 状态 
账单 状态 告诉 开发 者 其 是 否 为 App Engine 付 费 。 如 果 是 , 那么 会 向 开发 者 显示 已 经 付费 的 
资源 列表 ,以 及 这 些 资源 中 开发 者 已 经 使 用 了 多 少 。 默 认 情 况 下 ,， 它 只 标明 “免费 "， 因 为 
如 果 开 发 者 使 用 的 是 随 帐 户 供给 的 默认 资源 ， 这 些 资源 就 是 免费 的 。 
如 果 开 发 者 发 现 用 尽 了 免费 状态 的 资源 ， 那 么 ， 在 账单 状态 部 分 有 一 个 链接 ， 开 发 者 可 
以 在 此 购买 更 多 的 资源 。 我 们 将 在 18.5 节 中 讨论 资源 购买 的 内 容 。 
口 资源 
这 是 一 个 开发 者 可 以 使 用 的 资源 列表 ， 以 及 一 些 显 示 每 个 资源 已 经 使 用 了 多 少 的 小 图 表 。 
它 列 出 了 CPU 时 间 、 下 行 带宽 、 上 行 带 宽 、 存 储 的 数据 ， 以 及 电子 邮件 的 收 件 人 。 例 如 ， 
在 我 的 聊天 室 应 用 程序 中 ， 因 为 程序 没有 被 大 量 使 用 ， 所 以 ,今天 在 可 用 的 6.5 小 时 CPU 
时 间 中 ， 已 经 用 了 0.14 小 时 ， 使 用 了 大 约 可 用 带宽 的 3% 。 这 主要 是 由 于 我 一 直 让 客户 端 
打开 着 ， 并 在 过 去 的 三 小 时 中 每 秒 运 行 两 个 AJAX 调 用 所 造成 的 ! 
从 这 些 信息 中 ,已 经 可 以 得 出 一 些 有 趣 的 结论 。 查 看 带宽 使 用 率 时 ,我 可 以 看 到 一 个 问题 。 
有 一 个 客户 端 在 访问 我 的 聊天 室 , 但 我 实际 上 没 与 任何 人 聊天 。 其 实 是 应 用 程序 每 秒 稳定 地 运行 
两 个 查询 ， 稳 步 消耗 带 宽 。 如 果真 的 有 十 几 人 挂 在 上 面 ， 并 聊天 几 个 小 时 ， 可 能 真 会 耗费 完 带宽 
配额 。 因 此 ， 如 果 我 真 的 想 使 用 此 应 用 程序 ， 就 需要 减少 AJAX 更 新 的 频率 ， 减 少 更 新 请 求 的 大 
小 , 或 者 购买 更 多 的 带宽 。 对 于 该 应 用 程序 ， 最 好 的 选择 可 能 是 同时 采用 两 种 方法 。 我 并 不 真 的 
需要 每 秒 更 新 一 次 以 上 ， 这 样 就 可 以 仅 通过 减少 AJAX 更 新 的 频率 减少 一 半 的 带宽 使 用 。 除 此 之 
外 , 请 求 确实 是 非常 小 的 , 而 且 我 能 够 做 的 减 小 请 求 的 工作 不 多 。 所 以, 我 需要 购买 更 多 的 带宽 。 
在 仪表 板 上 ， 如 果 默 认 的 视图 不 能 给 开发 者 提供 足够 的 信息 ， 那 么 ， 开 发 者 可 以 深入 查看 ， 
以 获得 更 多 的 细节 。 几 乎 每 个 内 容 都 包含 链接 ， 通 过 连接 可 以 让 开发 者 获得 更 多 的 信息 。 例 如 ， 
可 以 通过 点 击 邻 近 “ 实 例 的 数量 ”( number of instances ) 的 “详情 ”( Details )， 获 得 更 多 有 关 实 
例 的 信息 。 
此 外 ， 让 我 们 看 一 下 面板 的 左 侧 ， 有 一 个 不 同类 别 的 列表 ,开发 者 可 以 进一步 深入 查看 ,得 
到 更 多 精确 的 信息 。 开 发 者 可 以 检查 配额 的 改变 情况 ,可 以 得 到 实例 的 非常 精确 的 信息 ,可 以 检 
查 自己 的 任务 队列 ， 等 等 。 


18.2 “小 探 数据 仓库 
正如 我 们 在 整 本 书 中 看 到 的 , App Engine 的 大 部 分 内 容 并 不 是 什么 新 东西 ,在 可 能 的 情况 下 ， 
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App Engine 尝 试 重用 各 种 标准 的 技术 支持 开发 者 的 云 应 用 程序 编写 。 App Engine 真 正 的 不 同 之 处 ， 
也 就 是 真正 新 络 的 一 个 内 容 , 就 是 数据 仓库 。 大 多 数 云 应 用 程序 框架 向 开发 者 提供 对 一 些 轻 量 级 
关系 数据 库 的 访问 , 如 MySQL。 但 App Engine 却 走 了 一 条 极为 不 同 的 路 线 , 使 用 数据 仓库 将 内 容 
存放 在 Google 的 Bigtable 中 。 

因此 , 当 开 发 者 管理 其 App Engine 应 用 程序 时 , 真正 重要 的 事情 就 是 理解 数据 是 如 何 存放 的 ， 
以 及 该 存储 模型 会 如 何 影响 资源 使 用 。 

在 App Engine 控 制 面 板 中 ， 有 一 组 视图 可 以 让 开发 者 窥视 和 探测 其 应 用 程序 是 如 何 使 用 数据 
仓库 的 。 

最 容易 查看 的 内 容 是 开发 者 的 数据 索引 方式 。 开 发 者 只 要 点 击 “ 数 据 仓 库 索 引 ”( Datastore 
Indexes )， 控 制 面板 就 会 显示 数据 仓库 中 存储 的 数据 类 型 列表 ， 以 及 这 些 数据 类 型 的 哪些 字段 被 
索引 。 这 在 早期 的 开发 过 程 中 非常 宝贵 。 数据 仓库 基于 开发 者 的 查询 自动 索引 一 些 字 段 。 通 过 查 
看 这 个 视图 ， 开 发 者 可 以 看 到 有 什么 索引 ， 以 及 没有 什么 索引 。 

开发 者 也 可 以 用 自己 的 方式 浏览 其 存储 的 所 有 对 象 。 开 发 者 只 要 点 击 “ 数 据 仓 库 视 图 ” 
( Datastore Viewer )， 就 可 以 看 到 在 数据 仓库 中 的 所 有 对 象 的 列表 ， 按 类 型 分 类 。 开 发 者 还 可 以 查 
找 特定 的 对 象 ， 只 要 点 击 数据 仓库 视图 中 的 “选项 ”( Options ) 链接 ， 它 就 向 开发 者 显示 一 个 用 
于 生成 当前 视图 的 GQL 查 询 , 而 且 开 发 者 可 以 编辑 该 查询 。 例如, 在 我 的 聊天 应 用 程序 的 数据 仓 
库 中 ， 有 PChatMessage 对 象 和 PChatRoom 对 象 。 我 可 以 输入 如 SELECT * FROM PChatMessage 
where senderName='markcc' 这 样 的 查询 ， 看 到 我 所 发 送 的 所 有 聊天 消息 。 

最 后 , 开发 者 可 以 看 到 对 象 占用 了 多 少 存储 空间 一 一 包括 它们 的 索引 的 元 数据 一 一 在 “数据 
仓库 统计 ”( Datastore Statistics ) 下 查看 。 


18.3 日 志和 调试 


当 应 用 程序 有 问题 时 , 整个 控制 面板 上 最 有 用 的 东西 就 是 日 志 。 日 志 按 照 与 开发 者 使 用 本 地 
调试 器 差不多 的 方式 ,提供 了 一 种 检查 所 运行 应 用 程序 的 方法 。 一 旦 应 用 程序 中 任何 内 容 发 生 错 
误 时 ，App Engine 就 会 生成 一 个 日 志 项 ， 通 过 查看 日 志 ， 开 发 者 就 可 以 看 到 发 生 了 什么 错误 。 

例如 , 打开 日 志 视 图 时 ， 就 可 以 看 到 我 在 聊天 应 用 程序 中 犯 了 一 个 错误 。 用 于 生成 聊天 视图 
的 模板 报告 说 应 该 有 一 个 网 站 图 标 , 但 并 没有 找到 可 用 的 网 站 图 标 。 因 此 ,每 个 页 面 浏览 请 求 结 
束 时 , 会 由 于 缺少 网 站 图 标 产 生 一 个 错误 。 这 并 不 会 导致 应 用 程序 无 法 工作 。 事 实 上 , 在 第 一 次 
检查 日 志 之 前 ， 我 甚至 不 知道 犯 了 这 样 的 错误 ! 但 这 正 是 日 志 为 何如 此 有 价值 的 原因 。 在 App 
Engine 中 ， 开 发 者 不 能 像 在 自己 的 计算 机 上 一 样 直 接 观察 到 应 用 程序 的 运行 。 应 用 程序 运行 在 其 
他 地 方 的 一 台 机 器 上 , 开发 者 不 能 直接 访问 。 但 经 由 日 志 这 种 宝贵 工具 ,开发 者 就 可 以 尽 可 能 
地 了 解 正在 运行 的 应 用 程序 的 信息 。 

当然 , App Engine 并 不 能 自动 告诉 开发 者 全 部 事情 。 它 无 法 准确 地 知道 开发 者 想 要 哪些 信息 。 
因此 , 它 自动 做 的 全 部 工作 就 是 记录 下 来 它 所 知道 的 错误 。 如 果 应 用 程序 试图 从 数据 仓库 访问 无 
法 找到 的 数据 ，App Engine 就 会 知道 该 事件 ， 就 可 以 在 日 志 中 生成 一 个 对 应 的 表 项 。 如 果 应 用 程 
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序 成 功 地 从 数据 仓库 中 取 回 了 信息 , 但 却 由 于 查询 语句 的 错误 而 导致 该 信息 不 正确 , 那么 , 由 于 
App Engine 无 法 知道 信息 是 否 正确 ， 所 以 它 根 本 不 会 自动 记录 任何 内 容 。 

可 以 使 用 编程 语言 中 的 标准 日 志 支 持 ( 如 Java 中 的 java.uti1.1ogging ) 在 应 用 程序 中 插入 

志 命 令 。 所 有 日 志 内 容 通过 点 击 控制 面板 中 的 “日 志 ”( Logs ) 选项 进行 查看 ， 这 是 开发 者 最 

宝贵 的 调试 工具 。 开 发 者 可 以 通过 生成 日 志 项 ， 准 确 地 看 到 其 应 用 程序 在 做 什么 。 

例如 , 现在 部 署 好 的 聊天 应 用 程序 的 版 本 包含 了 一 个 错误 。 如 果 给 应 用 程序 一 个 长 聊天 消息 ， 
它 将 无 法 正确 地 处 理 。 为 什么 呢 ? 

在 查看 缺 省 的 日 志 时 ， 我 看 到 一 推 条目 ， 像 图 18-3 中 所 示 ， 在 看 到 的 页 面 上 ， 都 是 抱怨 不 能 
处 理 长 于 $00 字 符 的 聊天 消息 ， 因 为 数据 仓库 模型 将 消息 内 容声 明 为 字符 串 特 性 ， 而 字符 串 不 能 
长 于 500 字 节 。 但 我 发 出 的 聊天 消息 没有 500 个 字符 长 度 ! 


EB 11-28 01:24PM 32.444 



































whioh can store strings of any length. 
图 18-3 ”控制 面板 日 志 视 图 的 一 个 日 志 项 


对 于 这 个 问题 , 默认 的 日 志 信 息 足 以 提供 一 定 的 线索 , 但 我 们 先 假设 它 没有 提供 充足 的 信息 。 
也 许 我 会 认为 聊天 消息 并 没有 那么 长 , 那么 可 以 在 应 用 程序 中 添加 日 志 代码 跟踪 调试 。 首 先 , 需 
要 在 源 文件 中 声明 日 志 记 录 需 。 因 此 ， 我 在 com.pragprog.aebook.persistchat.server. 
ChatSubmissionServiceImp1.java 中 添加 了 如 下 内 容 ， 在 最 后 面 ， 右 括号 之 前 : 


private static java.util.logging.Logger logger = 
java.util.logging.Logger.getLogger( 
ChatSubmissionServiceImpl.class.getName()); 


然后 ， 在 PostMessage 方 法 里 ， 添 加 一 个 日 志 语 句 : 


logger.info("Chat message Size = " + message.getMessage().length() + 
" with body \"" + message.getMessage() + "\""); 


通过 添加 的 语句 ， 每 一 个 发 布 的 消息 都 会 产生 一 个 日 志 条 目 ， 包 含 发 布 消息 的 长 度 和 内 容 。 
就 这 样 ， 我 可 以 确认 消息 确实 超过 了 500 个 字符 。 

不 过 , 给 开发 者 的 应 用 程序 添加 日 志 时 应 该 仔细 一 些 。 虽然 这 是 一 个 非常 优秀 的 工具 , 但 日 
志 却 会 占用 CPU 时 间 ， 会 算 作 开发 者 的 配额 。( 开发 者 并 不 需要 担心 空间 ，App Engine 只 保留 一 
定数 量 的 最 新 的 日 志 条 目 ， 自 动 丢 弃 旧 的 条 目 )。 因 此 ， 日 志 太 多 的 话 ， 渐 渐 地 就 会 浪费 资金 。 
虽然 不 多 ， 但 却 是 一 个 现实 问题 。 

更 重要 的 是 , 日 志 是 开发 者 理解 应 用 程序 实际 状况 的 主要 工具 。 如 果 为 每 件 小 事 都 生成 一 大 
堆 的 日 志 条 目 , 那么 日 志 里 就 挤 满 了 不 相关 的 数据 。 这 些 数据 会 使 得 重要 的 条 目 很 难 找到 ,或 者 
如 果 存 在 很 多 不 相关 数据 ,甚至 可 以 完全 挤 出 有 用 的 数据 ! 依照 经 验 来 看 ， 总 的 原则 是 不 记录 你 
不 想 主动 阅读 的 内 容 , 不 要 添加 那么 明知 道 永 远 都 不 会 看 的 日 志 条 目 。 但 当 遇 到 问题 时 ， 就 可 添 
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加 日 志 语 句 ， 以 便 了 解 发 生 的 问题 ， 然 后 进行 调试 时 ， 点 击 打开 控制 面板 中 的 日 志 即 可 。 


18.4 ”管理 应 用 程序 


控制 面板 包含 了 一 组 设置 ， 可 以 帮助 开发 者 管理 其 应 用 程序 。 有 4 个 视图 可 以 用 来 管理 ， 应 
用 程序 设置 ( Application Settings )、 权 限 ( Permissions )、 版 本 ( Versions ) 以 及 管理 日 志 (Admin 
Logs )。 
在 “应 用 程序 设置 ”视图 中 ， 开 发 者 可 以 访问 其 应 用 程序 的 一 组 基本 设置 。 包 括 以 下 内 容 。 
口 应 用 程序 标题 ( Application Title ) 
这 个 可 编辑 文本 框 中 产生 的 是 应 用 程序 名 称 。 想 要 改变 应 用 程序 名 称 ， 只 要 修改 文本 框 
内 容 并 单 击 “ 保 存 设置 ”( Save Settings ) 即 可 。 
口 配置 的 服务 ( Configured Services ) 
如 果 应 用 程序 要 使 用 任何 服务 ， 如 电子 邮件 或 者 XMPP ( 聊天 )， 服 务 就 会 在 这 里 列 出 ， 
还 有 各 个 可 配置 选项 。 
口 Cookie 到 期 时 间 ( Cookie Expiration ) 
App Engine 使 用 Cookie 对 用 户 进行 身份 验证 。 开发 者 可 以 在 设置 cookies 时 选择 该 用 户 保 持 
登录 一 天 ， 还 是 一 个 星期 。 
口 禁用 或 删除 应 用 程序 (Disable or Delete Application ) 
如 果 开 发 者 想 暂 时 或 永久 关闭 其 应 用 程序 ,那么 ， 这 里 可 以 完成 这 项 工作 。 只 要 开发 者 
点 击 “禁用 应 用 程序 ”( Disable Application )， 首 先 会 先 得 到 一 个 确认 对 话 框 ， 以 确保 真 
的 要 关闭 应 用 程序 。 如 果 开 发 者 确认 , 应 用 程序 就 会 被 禁用 , 并 且 Application Settings ( 应 
用 程序 设置 ) 视图 也 会 被 更 改 ， 变 为 包含 两 个 选项 一 一 一 个 重新 启动 应 用 程序 ， 一 个 永 
久 删 除 应 用 程序 。 
口 域 设置 ( Domain Setup ) 
如 果 开 发 者 想 在 自己 的 域 中 运行 其 应 用 程序 ， 可 以 在 这 里 告诉 App Engine 有 关 域 的 信息 。 
目前 ， 开 发 者 可 以 使 用 Google App 购 买 并 设立 一 个 域 ， 然 后 ， 让 其 App Engine 程 序 运 行 在 
该 域 中 。 此 外 ， 如 果 开 发 者 拥有 的 是 一 个 并 非 由 Google App 运 行 的 域 , 那么 ， 就 不 能 将 它 
用 于 其 App Engine 服 务 。 
开发 者 通过 权限 视图 给 其 他 用 户 管 理 权限 。 如 果 授 予 另 一 个 用 户 管理 权限 , 那么 他 将 能 够 访 
问 开 发 者 的 应 用 程序 的 整个 控制 面板 , 包括 可 以 更 改 任何 设置 、 修 改 代码 ,以 及 禁用 或 者 甚至 删 
除 应 用 程序 。 
版 本 视图 向 开发 者 展示 了 已 经 部 署 的 应 用 程序 的 版 本 的 列表 , 并 且 , 为 开发 者 提供 了 选择 其 
中 任何 一 个 作为 当前 活跃 版 本 的 能 力 。 这 样 做 的 主要 用 途 是 防止 错误 。 如 果 开 发 者 部 署 了 一 个 新 
版 本 的 应 用 程序 , 但 它 包含 一 个 错误 , 那么, 他 可 以 通过 访问 版 本 视图 ， 选择 之 前 一 个 没有 错误 
的 版 本 ， 从 而 立即 恢复 到 以 前 的 版 本 。 
最 后 ,管理 日 志 让 开发 者 看 到 其 应 用 程序 上 执行 了 什么 样 的 管理 操作 。 这 个 视图 的 主要 用 途 
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是 让 开发 者 监视 其 他 管理 员 的 操作 :任何 管理 员 执行 的 任何 操作 都 会 在 管理 日 志 中 生成 一 个 条 目 。 


18.5 ”支付 用 户 所 使 用 的 资源 


本 书 的 开头 说 过 , 云 计算 的 基本 特点 就 是 让 开发 者 购买 想 要 使 用 的 资源 。 开 发 者 不 用 购买 整 
台 计 算 机 以 确保 有 足够 的 CPU 应 付 偶 尔 到 来 的 高 峰 , 那样 只 会 让 那些 CPU 在 大 部 分 时 间 里 都 处 于 
闲置 状态 。 开 发 者 只 需 购买 其 所 需要 的 CPU 即 可 。 帐 单 面板 就 是 App Engine 让 开发 者 告诉 Google 
其 想 要 购买 多 少 资源 的 地 方 。 

控制 面板 上 有 一 个 “ 帐 单 设置 ”( Billing Setting ) 的 链接 。 如 果 开 发 者 点 击 该 链接 ， 它 就 会 
开启 账单 选项 。 默认 情况 下 ,开发 者 使 用 免费 资源 工作 一 一 Google 给 开发 者 提供 首次 资源 的 免费 
使 用 一 一 但 如 果 想 要 比 最 低 资源 更 多 的 资源 ， 就 需要 付费 了 。 

开发 者 使 用 帐 单 进行 控制 , 可 以 设置 一 个 每 日 预算 。 可 以 设 定 日 最 高 值 一 一 在 某 一 天 里 愿意 
为 额外 资源 支付 的 金额 上 限 。 开发 者 也 可 以 设置 每 个 资源 的 最 大 值 , 比如 说 :“ 我 愿意 每 天 为 CPU 
花费 最 多 4 美元 ， 但 带宽 只 有 1.5 美 元 。” 

开发 者 设置 了 预算 后 ， 可 以 使 用 Google Checkout 在 自己 的 信用 卡 上 设置 一 个 支付 项 。 

通过 查看 帐 单 记录 ， 开 发 者 可 以 精确 地 看 到 自己 正在 使 用 何 种 资源 ， 以 及 每 天 支付 多 少 钱 。 
在 帐 单 历 史记 录 中 有 每 日 的 条 目 , 采用 相同 的 格式 作为 日 志 项 , 告诉 开发 者 每 天 各 类 资源 的 消耗 
是 多 少 。 

在 这 一 章 中 , 我 们 已 经 快速 了 解 了 App Engine 的 控制 面板 为 开发 者 的 应 用 程序 提供 的 管理 控 
制 。 这 里 的 内 容 显得 有 些 平淡 无 奇 ， 因 为 这 一 切 都 非常 简单 ， 并 且 易 于 使 用 。 
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在 之 前 的 讲述 中 ,我 们 已 经 讨论 了 很 多 方面 的 内 容 。 此 时 ,开发 者 已 经 熟悉 Google App Engine 
编程 的 基础 知识 了 。 当 然 , 我 们 无 法 涵盖 所 有 内 容 , 但 是 ,现在 开发 者 已 经 可 以 构建 自己 的 第 一 
个 应 用 程序 ， 并 使 用 Google App Engine 的 在 线 文档 工作 了 。 在 本 章 中 ,我 们 将 回顾 一 下 已 经 介绍 
的 基本 概念 ， 并 介绍 一 下 开发 者 可 能 需要 看 的 其 他 内 容 ， 以 及 后 续 如 何 进 一 步 发 展 。 

















19.1 云 的 概念 




















正如 我 们 已 经 看 到 的 , 云 计算 编程 与 在 传统 环境 中 的 编程 非常 不 同 。 使 云 这 么 有 趣 和 强大 的 











关键 特性 包括 如 下 内 容 。 
口 开发 者 不 知道 














或 者 说 是 不 关心 














其 程序 在 哪里 运行 。 这 是 云 的 最 根本 的 特征 之 一 。 


开发 者 不 是 在 一 台 计 算 机 上 运行 应 用 程序 : 云 服务 提供 商 为 开发 者 提供 了 一 个 平台 , 更 





确切 地 说 ， 是 一 个 可 以 运行 以 特定 方式 编写 的 程序 的 基本 软件 系统 ， 而 | 




















是 所 有 的 底层 细 








节 是 平台 的 问题 ， 而 不 是 开发 者 的 问题 。 通 常 ， 开 发 者 不 知道 应 用 程序 运行 在 什么 样 的 
电脑 上 ， 或 者 运行 在 多 少 台电 脑 上 ， 这 些 计算 机 在 哪里 ， 或 者 运行 什么 操作 系统 。 这 些 


都 无 关 紧 要 。 


口 软件 是 一 种 服务 。 在 传统 的 编程 世界 里 ， 开 发 者 实现 运行 于 自己 的 计算 机 上 的 应 用 程序 。 
在 云 中 ， 开 发 者 仍然 编写 应 用 程序 ， 但 是 从 客户 的 角度 来 看 ， 云 中 的 程序 与 传统 的 程序 
并 不 是 完全 相同 的 ， 因 为 客户 不 运行 该 程序 。 在 云 中 ， 开 发 者 的 软件 是 一 种 服务 ， 是 一 
个 运行 在 其 他 地 方 的 应 用 程序 ， 当 用 户 想 要 使 用 该 程序 时 ， 通 过 他 们 的 网 络 浏览 咒 进 行 
访问 。 关 键 的 区 别 是 ， 用 户 不 运行 该 程序 ， 程 序 总 是 处 于 运行 状态 。 当 用 户 想 要 使 用 该 






















































































程序 时 可 以 连接 到 它 ， 而 且 用 户 并 不 需要 担心 如 何 运行 程序 ， 程 序 是 否 需 要 升级 ， 程 序 
是 否 在 他 们 的 计算 机 上 能 正常 工作 ， 或 者 类 似 的 事情 。 服 务 是 永远 存在 的 ， 随 时 可 以 被 











任何 地 方 的 任何 计算 机 访问 。 


口 








没有 任何 限制 ,开发 者 不 必 担 心 类 似 “ 我 的 计算 机 可 以 处 理 多 少 个 页 面 视图 ”这 样 的 限制 和 





问题 。 在 云 中 ， 一 切 都 是 有 弹性 的 。 如 果 开 发 者 突然 有 了 更 多 的 用 户 ， 也 不 是 问题 : 云 


平台 只 是 按照 用 户 需要 获取 更 多 的 资源 ， 并 继续 向 开发 者 的 客户 提供 服务 。 








口 开发 者 为 自己 所 使 用 的 东西 付费 。 在 云 中 , 开发 者 按照 规定 为 自己 所 使 用 的 各 种 资源 付费 。 
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开发 者 不 需要 为 了 以 后 可 能 的 需求 而 购买 庞大 的 、 功 能 强大 、 价 格 昂贵 的 计算 机 。 如 果 今 
天 只 需要 一 个 小 规模 处 理 器 ， 而 明天 需要 强大 一 千 倍 的 处 理 融 ,， 那 也 没 问题 。 今 天 ,开发 
者 为 一 个 处 理 絮 支付 几 美 分 ， 明天 ， 可 能 为 某 些 强大 的 计算 机 支付 几 美元 。 无 论 开发 者 需 
要 什么 ， 都 可 以 在 需要 时 为 其 付费 ， 而 且 使 用 完 后 ， 不 必 继 续 维持 过 度 的 硬件 资源 。 


19.2 Google App Engine 的 概念 


正如 本 书 介绍 的 ,Google App Engine 是 围绕 着 一 系列 基本 概念 构建 的 ,回顾 一 下 ,使 用 Google 

App Engine 进 行 云 编程 的 基本 概念 包括 以 下 内 容 。 

口 编程 的 过 程 就 是 实现 HTTP 请 求 处 理 的 过 程 。 在 Google App Engine 中 ， 开 发 者 的 编程 工作 
就 是 处 理 HTTP 请 求 。 通 过 神奇 的 网 络 回调 函数 ， 开 发 者 的 程序 与 用 户 以 及 其 他 应 用 程序 
的 每 一 次 交互 ， 都 可 以 实现 成 HTTP 请 求 处 理 程序 。 

口 开发 者 的 工作 基础 是 各 种 标准 。 在 Google App Engine 中 ， 如 果 可 能 的 话 ， 每 个 功能 尽 可 
能 基于 已 有 的 标准 技术 实现 。 因 此 ， 例 如 在 Python 中 ， 模 板 是 采用 被 广泛 使 用 的 Django 
模板 框架 构建 的 。 在 Java 中 ， 数 据 仓 库 的 接口 是 按照 标准 的 Java 数 据 对 象 框架 构建 的 。 纵 
观 Google App Engine， 我 们 已 经 看 到 ， 在 可 能 的 情况 下 ， 它 会 采用 已 有 的 标准 技术 作为 
其 基础 ， 而 不 是 发 明 新 的 东西 。 

口 一 切 都 是 服务 。 开 发 者 在 其 程序 中 进行 交互 的 Google App Engine 的 所 有 部 分 都 是 服务 。 
与 在 传统 的 程序 中 链接 的 函数 库 的 情况 类 似 ， 在 Google App Engine 的 云 应 用 程序 中 ， 开 
发 者 是 通过 RPC 请 求 来 与 服务 进行 交互 的 。 而 且 , 它 有 大 量 服务 可 以 被 开发 者 使 用 , 提供 
了 安全 、 数 据 存储 、 即 时 消息 等 全 部 内 容 。 

口 浏览 器 是 用 户 界面 。 用 户 界面 的 每 一 部 分 ， 用 户 所 看 到 的 一 切 内 容 ， 用 户 所 做 的 一 切 事 

情 ， 都 发 生 在 网 络 浏览 器 里 。 

口 没有 状态 。 在 传统 的 程序 里 ， 开 发 者 可 以 依靠 变量 来 保存 状态 一 一 也 就 是 说 ， 如 果 开 发 
者 把 某 内 容 存放 在 一 个 变量 里 ， 稍 后 回来 查看 该 变量 时 ， 它 仍然 存在 。 在 云 环 境 中 ， 这 
不 一 定 正确 。 开 发 者 编程 时 必须 意识 到 : 保持 状态 的 唯一 途径 就 是 使 用 数据 仓库 中 的 外 
部 存储 。 

口 时 刻 牢记 安全 。 在 云 应 用 程序 中 ， 安 全 比 在 传统 的 应 用 程序 中 更 需要 技巧 。 由 于 开发 者 
的 代码 作为 服务 在 运行 ， 可 以 被 恶意 攻击 者 在 线 访问 ， 而 且 用 户 的 数据 都 可 以 被 在 线 服 
务 访 问 ， 因 此 ， 开 发 者 必须 格外 注意 确保 系统 的 构建 是 安全 的 。 从 设计 系统 的 第 一 步 开 
始 ， 就 要 开始 设计 安全 策略 ， 并 确保 在 设计 的 每 一 个 细节 坚持 执行 此 安全 策略 。 所 有 的 
错误 都 将 危及 用 户 数据 的 安全 。 

这 些 基本 思想 组 成 了 Google App Engine 的 核心 。 昌 然 没 有 很 多 内 容 ,， 但 这 就 是 重点 。 正 是 基 

本 的 简单 性 ， 才 使 App Engine 成 为 用 起 来 如 此 完美 、 功 能 强大 的 系统 。Google App Engine 中 只 有 

这 组 适度 的 概念 和 围绕 这 些 概念 构建 的 库 , 仅 此 而 已 。 但 是 , 这 种 简单 的 框架 成 为 了 开发 者 用 于 

构建 自己 的 云 应 用 程序 的 非凡 的 、 一 流 的 工具 。 
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19.3 ”路 在 何方 


Google App Engine 是 一 个 非常 新 的 平台 ， 它 在 不 断 地 发 展 和 成 长 。 在 我 写 这 本 书 的 时 间 里 ， 
很 多 内 容 改 变 了 ， 以 至 于 我 不 得 不 重 写 相 关 的 整个 章节 。 当 读者 读 到 这 里 的 时 候 ，Google App 
Engine 里 可 能 会 有 更 多 新 的 东西 。 如 下 是 一 些 即 将 出 现 的 令 人 兴奋 的 变化 。 

口 数据 仓库 选项 。 在 写 这 本 书 的 时 候 ， 只 有 一 个 数据 仓库 的 实现 。 现 在 ， 在 我 写 这 个 总 
结 的 时 候 ， 第 二 个 数据 仓库 正在 测试 中 。 开 发 者 可 以 在 两 个 有 相同 接口 的 不 同 实现 中 
进行 选择 ， 从 而 能 够 选择 最 适合 其 应 用 程序 的 实现 。 当 前 的 实现 称 为 主 - 从 数据 仓库 
( master-slave datastore )。 主 -从 数据 仓库 仍然 会 是 默认 的 版 本 。 但 是 ， 如 果 采 用 主 -从 
数据 仓库 ， 那 么 ， 在 数据 中 心 的 维护 窗口 期 间 ， 开 发 者 数据 的 访问 有 可 能 会 被 中 断 。 
另 一 种 是 高 复制 数据 仓库 (high-replication datastore )。 高 复制 数据 仓库 速度 稍 慢 (最 
多 两 倍 )， 并 具有 最 终 一 致 性 ， 但 是 ， 可 以 保证 开发 者 的 数据 即使 面 对 重 大 破坏 ， 也 
始终 可 用 。 

口 开发 存储 。 这 是 当前 测试 部 署 的 令 人 兴奋 的 开发 之 一 。Google 提 供 了 非常 类 似 Amazon S3 
的 存储 服务 。 事 实 上 ， 开 发 者 可 以 很 容易 地 将 为 $3 编写 的 程序 移植 为 使 用 Google 开 发 存 
储 。Google 开 发 存储 也 有 一 些 自身 的 API， 使 其 成 为 一 个 非常 有 吸引 力 的 平台 。 这 是 App 
Engine 中 的 一 件 大 事 。 

口 MySQL 数 据 库 支持 。 如 果 开 发 者 已 经 有 一 个 应 用 程序 ， 并 且 想 要 将 其 迁移 到 云 或 者 开发 
者 真正 需要 或 者 喜欢 的 关系 数据 库 上 ， 那 么 ，Google App Engine 团 队 实 现 了 一 个 MySQL 
版 本 , 已 将 其 扩展 到 在 App Engine 云 内 工作 。 有 了 这 个 数据 库 , 开发 者 就 可 以 使 用 MySQL 
关系 数据 库存 储 来 代替 数据 仓库 了 。 

口 Go 语言 支持 。Google 的 一 个 团队 开发 了 一 个 漂亮 的 新 的 系统 编程 语言 ， 名 为 Go。 我 认为 ， 
Go 最 终 会 被 作为 开发 Google App Engine 程 序 的 语言 。Go 是 一 个 优秀 的 语言 ， 它 结合 了 
Python 的 简单 性 和 简洁 性 以 及 Java 的 安全 性 和 类 型 安全 。 当 Go 语言 出 现时 , 在 我 看 来 , 它 
会 是 Google App Engine 开 发 语言 的 首选 。 

口 Django nonrel。 目 前 ，Google App Engine 的 Python 开发 使 用 的 是 Django 框 架 的 模板 库 。 
Dijango 的 其 他 内 容 ， 特 别 是 其 数据 管理 框架 ， 非 常 优秀 ， 但 是 ， 与 数据 仓库 管理 数据 的 
方式 不 兼容 。 现 在 正在 努力 构建 一 个 Django 的 变种 版 本 ， 和 希望 其 能 够 与 数据 仓库 类 似 的 
非 关 系 对 象 存储 一 起 正常 工作 。 如 果 这 项 工作 完成 ， 在 GAE 开 发 中 ，Django 将 被 作为 网 
络 应 用 的 一 种 功能 齐全 的 替代 方法 。 

口 通道 。 目 前 在 Google App Engine 中 ,客户 需要 从 App Engine 的 服务 器 请 求 数据 。 在 聊天 应 
用 程序 中 ， 我 们 看 到 ， 使 用 这 种 机 制 ， 要 每 两 秒 就 发 送 更 新 请 求 ， 从 而 保持 聊天 窗口 是 
最 新 的 。 通 道 是 目前 正在 推动 支持 的 一 种 机 制 ， 它 提供 了 一 种 方式 ， 使 得 运行 在 云 服 务 
器 上 的 Google App Engine 服 务 能 够 向 客户 端 用 户 界面 发 送 更 新 ， 而 无 需 任 何 请 求 。 有 了 
通道 ， 不 使 用 轮 询 更 新 就 可 以 实现 我 们 的 聊天 服务 : 服务 器 只 要 使 用 一 个 通道 将 更 新 推 
送 到 客户 端 就 可 以 。 
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口 MapReduce。 对 于 数据 仓库 中 的 数据 的 复杂 计算 , 目前 开发 者 只 能 使 用 任务 队列 来 进行 简 
单 处 理 。Google App Engine 团 队 正在 开发 对 Google MapReduce 框 架 的 支持 ， 该 框架 用 于 
大 规模 并 行 计 算 。 当 这 项 工作 完成 时 ，Google App Engine 将 可 以 被 用 于 各 种 实现 并 行 计 
算 的 工作 负载 ， 如 生物 信息 学 处 理 等 。 

口 更 好 的 SSL 支 持 。 现 在 , 只 有 当 开 发 者 构建 运行 于 appspot.com 域 的 应 用 程序 时 , Google App 
Engine 才 允许 开发 者 使 用 SSL 安 全 通信 ,不 久 , 开发 者 就 可 以 通过 将 SSL 证 书 提 供给 Google 
App Engine， 在 自己 的 域 中 使 用 自己 的 SSL 密 钥 了 。 

这 些 仅仅 是 一 些 大 概 ， 还 有 非常 多 的 内 容 。 读 者 应 该 跟 进 App Engine 博 客 中 关于 所 有 变化 的 

言 息 一 一 包括 我 上 面 提 到 的 ， 以 及 更 多 的 信息 。 
正如 我 们 看 到 的 , Google App Engine 是 一 个 巨大 的 用 于 构建 基于 云 的 应 用 程序 的 系统 ,现在 ， 
你 已 经 知道 了 如 何 使 用 它 ， 所 以 ， 出 发 吧 ， 去 构建 一 些 伟 大 的 应 用 ! 
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口 Google App Engine 博 客 ， ea blogspot.com/。 

官方 的 Google App Engine 博 客 。 每 一 个 App Engine 开 发 人 员 都 应 该 跟 进 此 博客 。 

口 Google App Engine 的 社区 主页 ， /code.google.comy/appengine/community.html。 

App Engine 社 区 的 Google 代 码 交 换 场 所 。 这 个 网 站 包括 了 论坛 , 开发 者 在 那里 可 以 得 到 各 
种 问题 的 回答 、 示 例 应 用 程序 的 下 载 , 讨论 即将 推出 的 功能 、App Engine 的 系统 状态 信息 
和 常见 问题 等 ， 这 是 一 个 对 Google App Engine 开 发 者 来 讲 非常 棒 的 资源 。 
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“如 果 你 想 了 解 云 技术 并 学 习 Google App Engine 的 话 ， 本 书 绝对 是 上 上 之 选 。 你 可 以 看 到 用 两 种 语言 ( Python 
和 Java ) 编写 的 范例 。 在 介绍 技术 方面 ，Mark 做 得 实在 很 出 色 。 他 用 词 准确 ， 从 不 故弄玄虚 ， 阅 读 体验 极 佳 ， 让 我 
沉浸 其 中 。” 
一 一 Fred Daoud, Stripes: …and Java Web Development 1s Fun Again 作 者 
“简洁 的 代码 注释 详细 ， 优 美的 行文 解释 清晰 ， 这 本 书 可 以 满足 云 技 术 开 发 初学 者 的 全 部 需要 。” 
一 一 Dorothea Salo， 美 国威 期 康 星 大 学 麦迪 逊 分 校 
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云 计算 彻底 改变 了 应 用 程序 的 开发 与 使 用 方式 ， 甚 至 也 改变 了 应 用 程序 原本 的 定义 。 有 了 云 计算 ， 应 用 不 再 运行 
在 用 户 桌 面 计算 机 上 ， 而 是 分 布 式 地 运行 于 网 络 上 ， 与 全 世界 千 万 用 户 同 时 使 用 计算 资源 。 它 还 具有 传统 应 用 程序 所 
不 可 比拟 的 功能 多 样 性 及 可 扩展 性 。 在 诸多 构建 云 服务 的 新 环境 中 ，Google App Engine 以 其 强大 的 功能 和 易 用 性 无 疑 
成 为 非常 吸引 人 的 一 个 框架 。 

本 书 曾 述 了 云 应 用 的 内 涵 ， 剖 析 了 其 与 传统 应 用 的 区 别 ， 并 通过 使 用 Python 与 Java 对 一 个 简单 的 应 用 进行 不 断 的 
深入 开发 ， 揭 示 出 App Engine 的 各 方面 特性 ， 从 而 使 读者 顺利 掌握 构建 云端 应 用 程序 的 秘诀 


本 书 主要 内 容 

人 @ 云 服务 的 内 涵 及 其 与 传统 应 用 程序 的 区 别 @ 如 何 构 建 云 服务 

全 如 何 应 用 Python 或 Java, 采用 迭代 方式 开发 简单 的 云 应 用 程序 ”@@ 如 何 使 用 App Engine 管 理 持久 性 数据 

全 如 何 利 用 App Engine 提 供 的 便利 服务 外 如 何 保障 Web 应 用 程序 的 安全 性 

外 如 何 建立 在 用 户 浏览 器 上 运行 的 交互 式 用户 界 面 全 如 何 与 运行 在 App Engine 云 端的 其 他 服务 进行 交互 
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